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THE XXDP USER MANUAL CONSISTS OF THE FOLLOWING CHAPTERS: 

CHAPTER 1, XXDP INTRODUCTION 

CHAPTER 2. XXDP GENERAL USE DOCUMENTATION 

CHAPTER 3, XXDP UPDATE PROGRAMS II (UPDl) #2 (UPD2) (UPD2R) 

CHAPTER 4. XTECO - XXDP TEXT EDITOR PROGRAM 

CHAPTER 5, COPY - XXDP COPY PROGRAM 



APPENDIX A. XXDP RESIDENT MONITOR COMMANDS 

APPENDIX B, XXDP RESIDENT MONITOR ERRORS 

APPENDIX C, UPDl COMMANDS 

APPENDIX D, UPD2 COMMANDS 

APPENDIX E, PERIPHERALS SUPPORTED BY XXDP UTILITIES 

APPENDIX X, PROGRAM NAMING CONVENTIONS 



MAINDEC-n-02(jXA-I-D XXOp USfc-H MANUAL 21 J'J.Mf 197b MACYll 2?{732) 24-Jinj-7& ib:S9 PAGL i Stg fri6^«3 

DZQXAI.Pll 



CHAPTER 1. XXDP INTkODUCTIOM 



TABLE Qt CONTF.MS 

J . WHAT IS XXDP 

2. XXDP PEUUIREMENTS 

3. DISGLAlHfiPS 

4. COMTENTS OF A XXDP PACKAGE 

5. THE TCUP PACKAGE 

6. THE RKOP PACKAGE 

7. THE tmP PACKAGE 

8. THE TAOP PACKAGE 

9. THE HXOP PACKAGE 
li^. THE PPDP PACKAGE 

11, THE K8DP PACKAGE 

12, THE PSDP PACKAGE 

13, THE PMDP PACKAGE 



MAINOEC-1 1-DZQXA-I-D XXDP USEP MANUAL 21 JULY 1976 
DZQXAI.Pll 



MACYlt 27(732) 24-JUN-76 15;5<» PAGE 4 



SEQ 00(*4 



1. WHAT IS XXDP 



XXDP IS A "CATCH-ALL" NAME FOR A GROUP OF PDP-11 DIAGNOSTIC SuFTi^ARK 
PACKAGES AVAILABLE ON MULTIMEDIA, AND WHICH ARE PEPIODICALLY UPDATED. 
XXDP INCLUDES: 

TCDP - TCU DIAGNOSTIC PACKAGE (DECTAPE). 
RKDP - PKll DIAGNOSTIC PACKAGE {DECPACK), 

TMDP - TMn/TM02 DIAGNOSTIC PACKAGE (7 OR 9 TRACK MAGTAPE). 

9 TPACK CAN BE LOADED FROH TUIM OP TU16 
TADP - TAll DIAGNOSTIC PACKAGE (TMu CASSETTES). 
RXDP - RXU DIAGNOSTIC PACKAGE (FLOPPY DISK), 
RPDP - RPll DIAGNOSTIC PACKAGE 
RBDP - PH11/PP04 DIAGNOSTIC PACKAGE 
PSDP - RHI1/PS03 DIAGNOSTIC PACKAGE 
PMDP - RK06 DIAGNOSTIC PACKAGE 



THE XXDP PACKAGES CONTAIN THE pDp-ll FAMILY DIAGNOSTIC PROGRAMS IN 

MEDIA OTHER THAN PAPER TAPE. XXDP PACKAGES HAVE THE FOLLOWING ADVANTAGES: 

A. MOPE COMPACT STORAGE MEDIA, 

B. EASY AND CONVENIENT MEANS OF LOADING PROGRAMS UNOEP KEYBOARDD CONTROL, 

C. MEANS ARE PROVIDED FOP TJpDAIING AND MODIFYING PPOGPAMS. 

D. POSSIBLE TO SEQUENTIALLY RUN A SERIES OF PROGRAMS THROUGH USE 
OF THE "CHAIN MODE" FEATUHE. (PROGRAMS MUST BE CHAINABLE), 
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2, XXDP REOUIBEMENTS 



2.1 ALL XXDP PACKAGES REQUIRE: 

A. PDP-11 PROCESSOR WITH AT LEAST 8K STORAGE, 

B. CONSOLE DEVICE 

C. ONE OF THE DIAGNOSTIC PACKAGE MEDIA: 

1. TCn DECTAPE COhTROL AfiD TU56 TRANSPORT OR, 

2. PKll DISK CONTROL AND RK03 GR PK05 DRIVE OH, 

3. TAtl CONTROL AND TU6« CASSETTE DRIVE OR, 

4. TMU MAGTAPE CONTROL AND TU10 MAGTAPE DRIVE OR, 

5. TM02 MAGTAPE CONTROL UNIT AMD TU16 DRIVE OR, 

6. RXU/RXVlt FLOPPY CONTROL UNIT AND RXi^l FLOPPY DRIVE OR, 

7. RPH DISK CONTROLLER AND RP03 DRIVE OH, 

8. PH11/RP04 DISK CONTHOLLFR AND KP04 DRIVE OR, 

9. RH11/PS03 DISK CONTROLLER AND RS03 DRIVE. 

10. RK611 DISK CONTROLLER AND RK06 DRIVE. 

THE ABOVE REQUIREMENTS ARE FOR LOADING AND RUNNING DIAGNOSTIC PROGRAMS 
ALREADY STORED IN ONE OF THE DIAGNOSTIC PACKAGE MEDIA, THEY ARE ALSO 
SUFFICIENT FOR IMPLEMENTING PATCHES ON 4K OR SMALLER PROGRAMS VIA 
THE UPDATE tl PROGRAM. 



2.2 TO UPDATE A DIAGNOSTIC PACKAGE, THAT IS ADD NEW PROGRAMS OR NEW 

VERSIONS OF PROGRAMS TO THE PACKAGE, THE FOLLOWING HARDWARE IS REQUIRED: 

A, PC II HIGH SPEED RE AD LP, OR 

B, ASR 33 OR ASR 35 TELETYPE, 

SYSTEMS WITH TAll CASSETTE CONTROLS AMD TUfe0 CASSETTE DRIVES CAN ALSO 
BE UPDATED VIA CASSETTES, 

SYSTEMS WITHOUT PAPER TApE OR CASSETTE INPUT CAN ONLY BE UPDATED BY 
OBTAINING THE LATEST COPY OF THE REQUIRED DECTAPE, DECPACK, MAGTAPE, 
OR FLOPPY, FROM THE SOFTWARE DISTRIBUTION CENTER, 



2.3 OPTIONAL HARDWARE; 

A, BOOTSTRAP ROM FOP THE TCll, RKll, TAll, TMU, TM02, RXll, RXVll, RP03, RP04, OR HS03. 
IT MAKES LOADING THE XXDP MONITOR MORE CONVENIENT. 
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3, DISCLAIMERS 



3.1 THE XXOP PACKAGES HAVE BEEN DESIGNED FOR DIAGNOSTIC PURPOSES ONLY. 
THE XXDP SOFTWARE IS NOT INTENDED TO BE COMPATIBLE WITH ANY OTHER 
PDP-11 FAMILY SOFTWARE, AMY NON-DIAGNOSTIC USES OF THE SOFTii*ARE, OR 
USES OF THE SOFTWARE IN OTHER THAN THE MANNER DESCRIBED IN THIS 
DOCUMENT APE NOT SUPPORTED, 

3.2 THE XXDP PACKAGES ARE BINARY PACKAGES ONLY. THEY PROVIDE THE PDP-11 
FAMILY DIAGNOSTIC PROGRAMS IN THE VARIOUS MEDIA DESCRIBED, DOCUMENTATION 
FOR EACH OF THE PROGRAMS STORED IN A XXDP PACKAGE MUST BE OBTAINED 
SEPARATELY, FROM SOFTWARE DISTRIBUTION CENTER (SDC). HOWEVER, THIS 
DOCUMENTATION MUST BE OBTAINED AT THE SAME TIME AS THE PACKAGE, IN 
ORDER TO INSURE THAT THE DOCUMENTS AND THE PROGRAMS ARE AT THE SAME 
REVISION LEVEL. 



4, CONTENTS OF A XXDP PACKAGE 



THE BASIC PARTS OF A XXDP PACKAGE ARE: 

A. A CONTROL PROGRAM REFERRED TO AS THE "XXDP MONITOR". THE XXDP 
MONITOR PROVIDES THE MEANS TO LOAD PROGRAMS UNDER KEYBOARD CONTROL, 
AND TO OBTAIN A DIRECTORY OF CONTENTS OF THE XXDP MEDIUM 
(OECTAPE, MAGTAPE, ETC). 

B. XXDP UPDATE PROGRAM §% (UPDl). THIS 4K PROGRAM PROVIDES THE BASIC 
MEANS FOR MODIFYING AND UPDATING THE PROGRAMS IN THE XXDP PACKAGE. 
IT IS INTENDED FOR USE IN 8K SYSTEMS, 

C. XXDP UPDATE PROGRAM §2 (UPD2). A PROGRAM WITH A MORE COMPREHENSIVE 
SET OF COMMANDS THAT PROVIDE MORE CONVENIENCE AND EASE OF 
UPDATING THE XXDP PACKAGE. REQUIRES I 2K MINIMUM STORAGE. 

D. XXDP COPY PROGRAM, A PROGRAM THAT ENABLES THE USER TO DUPLICATE 
THE XXDP MEDIUM, THIS PROGRAM ONLY COPIES XXDP SOFTWARE, IT IS NOT 
A GENERAL PURPOSE COPY UTILITY PROGRAM, REQUIRES 8K STORAGE. 

E. XTECO XXDP TEXT EDITOR PROGRAM IS USED TO CREATE AND EDIT ASCII 
TEXT FILES FOR USE IN XXDP, SUCH AS BATCH CONTROL FILES FOR UP02 
PROGRAM OP CHAIN SEQUENCE FILES TO BE RUN BY XXDP MONITOR, 
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5, THE TCDP PACKAGE 



THE TCDP PACKAGE MAKES THE POP-U FAMILY DIAGNOSTIC PROGHAMS AVAILABLE 
ON DECTAPES, THE PACKAGE CONSISTS OF THE FOLLOWING ITEMSj 

HAINDEC-I t-DZQXA XXOP USER MANUAL (THIS DOCUMENT), 

MAINOEC-ll-DZZFA TCDP DECTAPE il. XXDP SOFTWARE, 

OTHER TCDP DECTAPES (IN EXCESS OF 20) CONTAINING THE POP-11 FAMILY 
DIAGNOSTIC PROGRAMS, 

ONLY THOSE DECTAPES REQUIRED TO SUPPORT THE TARGET SYSTEM NEED BE 
ORDERED, DECTAPE »1 SHOULD ALWAYS BE ORDERED. THE PDP-11 MAINOEC 
INDEX LISTS THE CONTENTS OF EACH TCDP DECTAPE, IT SHOULD BE REFERENCED 
TO DETERMINE THE DECTAPES THAT ARE HEEDED, 

6, THE RKDP PACKAGE 



THE RKDP PACKAGE PROVIDES THE PDP-lt FAMILY DIAGNOSTICS OH DECPACK, 
IT CONSISTS OF THE FOLLOWING ITEMS THAT MUST BE ORDERED INDIVIDUALLY: 

HAINOEC-1 1-OZOX* XXDP UStR MANUAL (THIS DOCUMENT). 

MAINDEC-11-DZZAA XXDP'PKDP RKU DIAGNOSTIC PACKAGE DISK 1 



MAINDEC-H-OZZZB 
MAINDEC-I1«4)2ZZC 



XXDP-RKDP RKIl DIAGNOSTIC PACKAGE DISK 2 
XXDP-RKDP RKU DIAGNOSTIC PACKAGE DISK 2 
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7. THE TMDP PACKAGE 



THE TMPP PACKAGE PROVIDES THE PDP-ll FAMILY DIAGNOSTICS ON 7 OR 9 

TRACK MAGTAPE {TU10/TU16/TS«3) . THE PACKAGE CONSISTS OF THE FOLLOWING ITEMS 

THAT MUST BE ORDERED INDIVIDUALLY: 

MAINDEC-I 1-DZOXA XXDP USER MANUAL (THIS DOCUMENT), 

MAIN0EC-11-DZZAC-A-MB7 XXDP-THDP TMU DIAGNOSTIC PACKAGE (7 TRACK) OR, 

MAINDEC-U-DZZAC-B-MB9 XXDP-TMDP TMll /TM02/TS03 DIAGNOSTIC PACKAGE (9 TRACK). 

THE TMDP 9 TRACK PACKAGE CONTAINS THE THDP AND 
TMDP MONITORS WHICH ENABLE THE SAME TAPE 
TO BE USED FOR EACH DRIVE. 

8. THE TAOP PACKAGE 



THE TADP PACKAGE CONSISTS OF THE FOLLOWING ITEMS THAT MUST BE ORDERED 
INDIVIDUALLY: 

MAINDEC-1 1-DZOXA XXDP USER MANUAL (THIS DOCUMENT), 

MA1NDEC«II-DZZDH-A'-TB XXDP-TAOP TAll DIAGNOSTIC PACKAGE CASSETTE. 

THE TADP TAll DIAGNOSTIC PACKAGE CASSETTE CONTAINS ONLY THE PROGRAMS 
REOOIREO TO PROVIDE LOADING, COPYING, AND UPDATING FACILITIES, THE 
DIAGNOSTIC PROGRAMS ARE STORED IN STANDARD TAll CASSETTES THAT MUST 
BE' OBTAINED SEPARATELY. REFER TO MAINDEC INDEX FOR A LIST OF AVAILABLE TAll 
CASSETTES AND THEIR CONTENTS, 



9, THE RXDP PACKAGE i 



THE RXDP PACKAGE CONSISTS OF THE FOLLOWING ITEMS THAT MUST BE ORDERED 
INDIVIDUALLY: 

MAINDEC-1 1-DZOXA XXDP USERS MANUAL (THIS MANUAL) 

HAINDEC-ll-DZZGA RXDP FLOPPY il, XXDP SOFTWARE, 

OTHER RXDP FLOPPIES (IN EXCESS OF 2H) CONTAINING THE PDP-11 FAMILY 
DIAGNOSTIC PROGRAMS. 

REFER TO MAINDEC INDEX FOR UP-TO-DATE LIST OF RXll DISKETTES AND THEIR CONTENTS, 
OR REFER TO PDP-11 SOFTWARE PRICE LIST. 
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10, THF. HPDP PACKAGE 



THK RPDP PACKAGE CONSISTS OF THf FOtLOfejlNn ITEMS THAT MUST 
BE ORDERED i I VIDUALLY ; 

MAINDEC-U-DZOXA XXDP users HAMUAL (THIS MANUAL)* 

MAlNDEC-ll-DZQOil PPDP-XXDP RPt I /PPi(*2/RPHl MONITOR, AVAILABLE 0^ PAPER TAPE, 

IT IS ALSO AVAILABLE AS A FILE IN OTHtR XXDP PftCAGES, 



1 1 , THE RBDP PACKAGE 



THE RPUP PACKAGE CONSISTS OF THE FOLLOWING ITEMS THAT MUST BE 
ORDERED INDIVIDUALLY: 

MAINDEC-U -DZaXA XXDP USERS MANUAL (THIS MANUAL), 

MAINDEC-U-DZOUO RBPP-XXDp RP04 MONITOR, AVAILABLE ON PAPER TApE, 

IT IS ALSO AVAILABLE AS A FILE ON OTHER XXDP pACAGES, 



12. THE RSDP PACKAGE 



THE RSDP PACKAGE CONSISTS OF THE FOLLOWING ITEMS THAT MUST HE 
ORDERED INDIVIDUALLY: 

MAINDEC-U-DZOXA XXDP USERS MANUAL (THIS MANUAL), 

MAINOEC-1 1 -OZOUP RSDP-XXOP RS04 MONITOR, AVAILABLE ON PAPER TApE, 

IT lA ALSO AVAILABLE AS A FILE ON OTHER XXDP pACAGES, 



13, THE RMDP PACKAGE 



THE RMDP PACKAGE CONSISTS OF THE FOLLOWING; 
MAINDEC-U-DZOXA XXDP USER MANUAL (THIS MANUAL), 

MAlNDEC-1 1-DZZRA XXDP RMDP RK06 DIAGNOSTIC PACKAGE, 
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CHAPTCP 2, XXDP GENERAL USE DOCUMENTATION 



TABLE OF CONTENTS 



1. LOADING PROCEDURES 



1.1 LOADING TCDP MONITOR 

1.2 LOADING RKDP MONITOR 

1.3 LOADING TADP MONITOR 

1.4 LOADING TMDP MONITOR 

1.5 LOADING RXDP MONITOR 

t,6 LOADING THE RPDP MONITOR 

1.7 LOADING THE RBDP MONITOR 

1.8 LOADING THE RSDP MONITOR 

1.9 LOADING THE RMDP MONITOR 

2, USE PROCEDURES 



2.1 SETTING THE CONSOLE FILL COUNT 

2.2 OBTAINING A DIRECTORY 

2.3 LOADING AND RUNNING PROGRAMS 

2.4 CHAIN MODE OPERATION 

2.4.1 CHAIN PROGRAM COMMANDS 

2.4.2 MAKING A CHAIN 

2.4.3 PUNNING A CHAIN 

2.5 TADP MONITOR EXCEPTIONS. 

3, ERRORS 



3.1 



XXDP RESIDENT MONITOR ERRORS 
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1. LOADING TROCfDliPfS 



1,1 LOAOING TCDP MONITOR 



THE TCDP MOHITOB Cft« BE LOADED B\ MEAKS OF THE l:iM792yB ROM HOOT, 
MRll-DB BOMM BOOT, OR VIA A "TOGGLE-IN" PROCEDURE. 

1.1.1 VIA BM792yB BOOTSTRAP LOADER 



A. MOUNT THE DESIRED TCDP DECTAPE ON DECTARE DRIVE H, 

B. MAKE DRIVE READY AND WRITE LOCK IT. 

C. LOAD ADDRESS 173100 

D. SET SR TO 177 34 4 

E. PRESS START 

F. GO TO 1.1.4 STEP A. 

1.1.2 VIA HRlt-DB BOOTSTRAP LOADER 



A. MOUNT THE DESIRFO TCDP DECTAPE ON DECTAPE DRIVE 0. 

B. MAKE DRIVE READY AND WRITE LOCK IT, 

D, PRESS START 

E. GO TO 1.1 ,4 STEP A, 

1.1.3 VIA "TOGGLE-IN" PROCEDURE 



A. MOUNT THE DESIRED TCDP DECTAPE ON DECTAPE DRIVE ft. 

B. MAKE DRIVE READY AND WRITE LOCK IT. 

C. LOAD ADDRESS 177 342 

D. DEPOSIT VALUE 004003 

E. DECTAPE WILL REWIND AND STOP IN END ZONE. THE REMOTE LIGHT 
ON DRIVE SHOULD REMAIN LIT. 

F. PRESS EXAMINE KEY, 

G. DEPOSIT VALUE 000001, REMOTE LIGHT SHOULD GO OUT. 

H. LOAD ADDRESS 00«>216 

I. DEPOSIT SEQUENTIALLY THE FOLLOWING VALUES: 

012737,000005, 1 77342,000777 

J, LOAD ADDRESS 000216 

K. PRESS START 

L. GO TO 1.1.4 STEP A. 
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1,1.4 COMMON PROCEDURE 



A. THE MONITOR Is LOADED FROM MEDIUM. 

B, THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN READY 
TO ACCEPT KEYBOARD COMMANDS, 

DZOUC-E 21-JUL-76 TCDP - TCll MONITOR NNK 
RESTART ADDP:XXXXXX 
BOOTED VIA UNITI: f 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C (*C) 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CR> FOR DIRECTORY ON CONSOLE, OR 

D/F<CR> FOR SHORT DIRECTORY ON CONSOLE, OR 

D/L<CR> FOR DIRECTORY ON LINE PRINTER, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO PUN COPY PROGRAM, 

R FILENAHE<CR> TO RUN ANY OTHER PROGRAM, 

L FILENAME<CR> TO LOAD A PROGRAM ONLY 

S<CP> TO START THE PROGRAM JUST LOADED, 

S ADDR<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAME<CP> TO RUN A CHAIN, 

C FILENAME/QV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE. 
REFER TO XXDP MANUAL MD-ll-DZOXA FOR ADDITIONAL HELP, 



WHERE: NNK IS THE SYSTEM'S STORAGE UP TO 28K, 

XXXXXX IS THE MONITOR'S RESTART AODP : ADDRESS , 

THE DOT (,) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 

C, THE HELP FILE MAY BE ELIMINATED BY TYPING CTL C. 

D. GO TO SECTION 2. USE PROCEDURES, 



NOTE: <CR> MEANS PRESSING THE "RETURN" KEY ON KEYBOARD, 
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1,2 LOADING hKOP MONITOR 

THE RKDP MONITOR CAN BE LOADED By MEANS OE THE BM792YB ROM BOUT, 
MRU -OB ROM BOOT, OR VIA A "TOGGLE-lk" PROCEDURE, 

i.2.1 VIA BH792YB BOOTSTRAP LOADER 



A. MOUNT THE RKOp DECPACK ON DRIVE H, 

B. LOAD DRIVE. WRITE LOCK IT, WAIT UNTIL DRIVE IS READY. 

C. LOAD ADDRESS 17 3100 

D. SET SR TO 177 406 

E. PRESS START 

F. GO TO 1,2,4 STEP A 

1.2.2 VIA MRtl-DB BOOTSTRAP LOADER 



A. MOUNT THE RKDp DECPACK ON DRIVE 0, 

B. LOAD DRIVE, WRITE LOCK IT. V^AIT UNTIL DRIVE IS READY, 

C. LOAD ADDrc'SS 173110 

D. PRESS START 

E. GO TO 1,2.4 STEP A 

1,2,3 VIA "TOGGLE- IN" PROCEDURE 



A. MOUNT THE pKUp DECPACK ON DRIVE 0. 

B. LOAD DRIVE. WRITE LOCK IT. WAIT UNTIL DRIVE IS READY. 

C. LOAD ADDRESS 177404 

D. DEPOSIT VALUE 000001 

E. LOAD ADDRESS 010000 

F. DEPOSIT VALUES 0127 37,000005,177404,000777 

G. LOAD ADDRESS 010000 

H. PRESS START 

I. WAIT ONE SECOND, PRESS HALT, 
J, LOAD ADDRESS 000000 

K, PRESS START 

L, GO TO 1,2,4 STEP A 



NOTEilli THE RKOp DISK MAY BE BOOTED AND RUN FROM A DRIVE OTHER THAN 
DRIVE (ANY DRIVE BETWEEN AND 7), PROVIDED THE ROM USED 
SUPPORTS MULTIPLE DRIVE BOOTING, 
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1,2,4 COMMON PROCEDURE 



A, THE MONITOR IS LOADED FROM MEDIUM, 

B. THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN RKADY 
TO ACCEPT KEYBOARD COMMANDS. 

DZOUO-E 2t-JUL-76 RKDP - RKll MONITOR NNK 
RESTART ADDRsXXXXXX 
BOOTED VIA UNIT*: 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C CO 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CR> FOR DIRECTORY ON CONSOLE, OR 

D/F<CR> FOR SHORT DIRECTORY ON CONSOLE, OR 

D/L<CR> FOR DIRECTORY ON LINE PRINTER, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO RUN COPY PROGRAM, 

R FILENAME<CH> TO RUN ANY OTHER PROGRAM. 

L FILENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDP<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAMF<CR> TO RUN, A CHAIN, 

C FILENAME/OV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE, 
REFER TO XXDP MANUAL Mp-U-DZOXA FOP ADDITIONAL HELP, 



WHERE: NNK IS THE SYSTEM'S STORAGE UP TO 28K, 

XXXXXX IS THE MONITOR'S RESTART ADDRESS, 

THE DOT (.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 

C, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C, 

D. GO TO CHAPTER 2. USE PROCEDURES, 



NOTE: <CR> MFANS PRESSING THE "RETURN" KEY ON KEYBOARD, 



LOADING TADP MONITOR 



THL TADP MONITOR CftH HE LOADFD B¥ MEANS OF THt HM792!fH POM bOOT Ai> FOLLOWS: 

A, MOUNT THE TADP CASSETTE IN DRIVE (LEFT HAND DpIVEJ. THE CASSETTE 

SHOULD BE WHITE-LOCKED TO PPFVENT ACCIDENTALLY WHITING ON IT. 
b, LOAD ADDPESS |733«f 

C, PHESS START 

D, THE MGNITOF IS LOADED FROM MEDIUM, 

E, THE MONITOP TYPES THE FOLLOWING MESSAGE AND IS THEN HEADY 
TO ACCEPT KEYBOARD COMHA«DS, 

DZQUE-F 2I-JUL-76 TADP - TAU MONITOR NNK 
RESTART ADDR;XXXXXX 
BOOTED VIA UNIT* J (?» 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C (*C) 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CP> FOR DIRECTORY ON CONSOLE, OR 

D/F<CP> FOP SHORT DIRECTORY ON CONSOLE, OR 

D/L<CR> FOR DIRECTORY ON LINE PRINTER, OR 

l)/L./F<CR> FOR SHORT DIRECTORY ON LINF PRINTER. 

R COPY<CP> TO PUN COPY PROGRAM, 

R FILENAME<CR> TO BUN AMY OTHER PROGRAM. 

L FILENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDP<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAME<CR> TO RUN A CHAIN, 

C FILrNAME/OV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE, 
REFER TO XXDP MANUAL MD-U-DZOXA FOR ADDITIONAL HELP, 



WHERE: NNK IS THE SYSTEM'S STORAGE UP TO 2eK, 

XXXXXX IS THE MONITOR'S RESTART ADDRESS. 

THE DOT (.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 

F, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C, 

G, GO TO CHAPTER 2, USE PROCEDURES. 



MAIHDEC-ll-OZOXA-I-0 XXDP USEP HANUAL 21 JULY 1«»76 
DZQXAI.Pll 



MACYll 27(732) 24-JUN-76 15:59 PAGE 17 



SEQ 0016 



1.4 LOADING THDP MOHITOP 



THE THDP MONITOR CAN BE LOADED BY ANY OF THE ACCEPTABLE ROHS* 
OR VIA A "TOGGLE-IN" PROCEDURE. 

THE TOGGLE-IN PROCEDURE IS ONLY VALID FOR THE TMll. 
1.4.1 VIA BOOTSTRAP LOADER 



A. MOUNT THE TMDp TAPE ON DRIVE AND MAKE READY. 

B. REWIND DRIVE » TO "BOT" AND SET "ON-LINE" 

C. LOAD THE PROPER ADDRESS CORRESPONDING TO THE 
ROM/TAPE DRIVE CONFIGURATION. 

D. PRESS START 

E. GO TO 1.4.3 STEP A. 

1.4.2 VIA "TOGGLE-IN" PROCEDURE 



A. MOUNT TMDP TAPE ON DRIVE AND HAKE READY. 

B. REWIND DRIVE TO "BOT" AND SET "ON-LINE". 

C. LOAD ADDRESS 010000 

D. DEPOSIT THE FOLLOWING VALUES: (FOR TMll) 

0051 37, 172524e*»l 2737, 06001 If 172522 
000777,0127 37,060003,172522,1057 37 
172522, 100375,0001 37,000000 
GO TO STEP E 



DEPOSIT THE FOLLOWING VALUES: (FOR TMH2) 
0127 37,001300,172472,0127 37 
177777,172446,0127 37,000031,172440 
1057 37, 172452, 100375,0127 37, 177400 
172442,005037, 172444,0427 37,000007 
172452,0127 37,000071, 172440, 105737 
17 2440,000100,000375,0001 37,000000 
GO TO STfP H 



E. LOAD ADDRESS 010000 AND PRESS START. 

F. AFTER ONE SECOND DEPRESS HALT. LOAD ADDRESS 010014, PRESS START. 

G. GO TO 1.4.3 STEP A. 

H. LOAD ADDRESS 10000 AND PRESS START. 

I. GO TO 1.4.3 STEP A. 



HAINDEC-i i -DZuXA-i-D XXOP USEH HaNUAL 2! JULY lllb 
0ZQXAI,P1 1 



MalxU 27(732) 24-JUN-7b 15:S9 PAGE 18 



SfcIO 0017 



1,4.3 COMMON PPOCKOUBK 



A. THE. MOHITOR IS tOADfcID FROM MEDIUM. 

B, THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN HEADY 
TO ACCEPT KEYBOARD COMMANDS , 

DZQUF-F 21-JUL-76 TMDP - TMll MONITOR NNK 

OR 



DEOUH-C 21-JUL-76 THDP - TMk)2/TUJfa MONITOR NNK 
RESTART ADDfijXXXXXX 
BOOTED VIA UNITX: 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C (*C) 
TYPE; 

F<CP> TO SET CONSOLE FILL COUNT 
D<CH> FOP DIRECTORY ON CONSOLE, OR 
D/F<CR> FOR SHORT DIRECTORY ON CONSOLE, OR 
D/L<CR> FOR DIRECTORY ON LINE PPINTEP, OR 
D/L/F<CR> FOR SHOPT DIRECTORY ON LIME PRINTER, 

f\ v-vrA-^v-rv^ Av» jpw^ vutk r cwj \rr- r%*'* $ 

R FILENAME<CP> TO RUN ANY OTHER PROGRAM, 

L FILENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDP<CP> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAHE<CR> TO RUN A CHAIN, 

C FILENAME/QV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE. 
REFER TO XXDP MANUAL MD-ll-DZQXA FOR ADDITIONAL HELP, 



WHERE: NMK IS THE SYSTEM'S STORAGE UP TO 28K, 

XXXXXX IS THE MONITOR'S RESTART ADDRESS. 

THE DOT (.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 

C, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C. 

D. GO TO CHAPTER 2. USE PROCEDURES. 



NOTE: <CR> MEANS PRESSING THE "RETURN" KEY ON KEYBOARD. 
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1,5 LOADING RXDP MONITOP 



THE RXDP MONITOR CAN BE LOADED BY WEANS OF THE BOOTSTRAP LOADER, OR VIA 
"TOGGLE-IN" PROCEDURE, 

1.5.1 LOADING THE ltV03 SYSTEM 



A, WITH THE SYSTEM POWERED UP IN ENABLE MODE THE PROMPT CHARACTER (S) IS 
TYPED AND THE USER TYPES IN THE DEVICE CODE AND <CR>j 

$ (PROMPT) DX<CR> (USER ENTRY) 

THIS BOOTS THE RXDP AND STARTS THE MONITOR. 

B. IN THE CONSOLE HALT MODE (ODT) THE PROMPT CHARACTER (P) IS 
TYPED AND THE ^NSWER IS THE ADDRESS OF THE BOOT ROM 

AND A G (GO) <CR>. 

P (PROMPT) 173000 G<CR> (USER ENTRY) 

THIS ENABLES THE PROMPT "S", PROCEED AS IN CHAPTER "A" ABOVE, 

C. THE TOGGLE-IN PROCEDURE IN CHAPTER 1,5.3 MAY BE ENTERED 
AFTER THE PROMPT USING THE <CR> AS A TERMINATOR AND 
<LF> AS AN ADVANCE TO THE NEXT LINE, TO START ENTER 
ADDRESS AND "G", 

D, GO TO COMMON PROCEDURE 1,5,4 



note: 



ON ALL 11V03 SYSTEMS THE LINE CLOCK MUST BE DISABLED VIA THE LTC SWITCH, 
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I ,5.2 



VIA 



BOOTSTRAP LOAOKK 



A, MOUNT THE RXOP DiSKtTTF ON PRJVK 0. 

B, LOAD AND WAIT UNTIL DRlVt; FtADY, 

C, LOAD AOnptSS 

D, PPtiSS START. 

E, GO TO 1.5,3. 



1,5.3 VIA "TOGGI E-lti" PPOCEDUFK. 



A. MOUNT PXPP DISKETTE ON PPIVE «. 

B. LOAD AND WAIT UN TIL DRIVE READY, 

C. LOAD FOLLOWING BOOTSTRAP: 



ADDRESS 



CONTENTS 



1 0t»0 



12701 

177170 

105711 

177b 

12711 

3 

57J 1 

1776 

1PI0405 

l«57ll 

100004 

1 16120 

2 

770 



5000 
1 10 







2 
4 
6 
10 
12 
14 
16 
20 
22 
24 
26 
30 
32 
34 
36 
40 
42 
44 
46 



1050 



D, LOAD ADDRESS 1000 

E, PRESS START 
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1,5,4 COMMON PHOCEDURE 



A, THE MONITOR IS LOADED FROM THE MEDIUM. 

B, THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN 
READY TO ACCEPT KEYBOARD COMMANDS, 

DZOUJ-C 21-JUL-76 PXOP - RX11/RX01 MONITOR NNK 
RESTART ADDP:XXXXXX 
BOOTED VIA UNITI: 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C CO 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CR> FOR DIRECTORY ON CONSOLE, OR 

n/F<CR> FOP SHORT DIRECTORY ON CONSOLE, OR 

D/L<CP> FOR DIRECTORY ON LINE PRINTER, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO RUN COPY PROGRAM, 

R FILENAME<CR> TO PUN ANY OTHER PROGRAM. 

L FTLENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDR<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAME<CR> TO RUN A CHAIN, 

C FILFNAME/OV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE. 
REFER TO XXDP MANUAL MD-il-DZOXA FOR ADDITIONAL HELP. 



WHERE: NNK IS THE SYSTEMS STORAGE UP TO 2RK, 

XXXXXX IS THE MONITORS RESTART ADDRESS. 

THE DOT (.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 

C, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C. 

D, GO TO CHAPTER 2. USE PROCEDURES. 



NOTE: <CR> MEANS PRESSING THE "RETURN" -FEY ON THfc KEYBOARD. 
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1,6 LOADING THE RPUP MONITOR 



the: RPDP MONITGF CAN BE LOAOtO BY MEANS OF THE POM riOOT ftHICH 
SUPPORTS THE RPi,?3. 

1,6,1 VIA THE ROM BOOTSTRAP LOADER 



A, MOUNT THE RPDP DISK ON DRIVE 0. 

B, LOAD AND wAlT UNTIL DRIVE IS READY. 

C, LOAD PROPER ROM ADDRESS FOR PPiii , 

D, PRESS START. 

1.6,2 COMMON PROCEDURE 



A. THE MONITOR IS LOADED FROM THE MEDIUM. 

H, THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN READY TO 
ACCEPT KEYBOARD COMMANDS, 

DZQUN-B 21-JUL-7b RPDP - RPU MONITOR NNK 
RESTART ADDR:XXXXXX 
BOOTED VIA UNITt: » 

TO ABORT THF FOLLOWING HELP MESSAGE TYPE CTRL C £*C) 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CR> FOP DIRECTORY ON CONSOLE, OR 

D/F<CR> FOR SHORT DIRECTORY ON CONSOLE, OR 

D/L<CR> FOR DIRECTORY ON LINE PP1MTE:R, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO RUN COPY PROGRAM, 

R FILENAME<CR> TO RUN ANY OTHER PROGRAM. 

L FILENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S AODR<CP> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILEMAME<CR> TO RUN A CHAIN, 

C FILENAME/OV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE. 
REFER TO XXDP MANUAL MD-ll-DZQXA FOR ADDITIONAL HELP. 



WHERE: NNK IS THE SYSTEMS STORAGE UP TO 28K, 

XXXXXX IS THE MONITORS RESTART ADDRESS. 

THE C.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDS. 



C. THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C. 

D. GO TO SECTION 2. USE PROCEDURES, 
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1,7 LOADING THE PBDP MONITOR 



THE RBDP MONITOR CAN BE LOADED BY MEANS OF THE ROM HOOT WHICH SUPPORTS 
THE RP04 DISK, 



1,7,1 VIA THE ROM BOOTSTRAP LOADER 



A, MOUNT THE RBDP DISK ON DRIVE 0. 

B, LOAD AND WAIT UNTIL DRIVE IS FEADY. 

C. LOAD PROPER ROM ADDRESS FOR THE RP04, 

D. PRESS START, 

1,7,2 COMMON PROCEDURE 



A, THE MONITOR IS LOADED FROM THE MEDIUM, 

B. THE MONITOR TYPES THE FOLLOWING MESSAGE AND IS THEN READY TO 
ACCEPT KEYBOARD COMMANDS; 

DZOUO-B 21-JUL-76 RBDP - RP04 MONITOR NNK 
RESTART ADDR:XXXXXX 
BOOTED VIA UNIT!: 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C I *C ) 
TYPE: 

F<CR> TO SET CONSOLE FILL COUNT 

D<CR> FOR DIRECTORY ON CONSOLE, OR 

D/F<CR> FOP SHORT DIRECTORY ON CONSOLE, OR 

D/L<CP> FOP DIRECTORY ON LINE PRINTER, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO RUN COPY PROGRAM, 

R FILENAME<CR> TO PUN ANY OTHER PROGRAM, 

L F1LENAME<CR> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDR<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAHE<CR> TO PUN A CHAIN, 

C FILENAME/QV<CR> TO RUN A CHAIN IN QUICK VERIFY MOPE, 
REFER TO XXDP MANUAL MD-U-DZOXA FOR ADDITIONAL HELP. 



WHERE; NNK IS THE SYSTEMS STORAGE UP TO 28K, 

XXXXXX IS THE MONITORS RESTART ADDRESS. 

THE (.) INDICATES THE MONITOR IS READY TO ACCEPT COMMANDiS. 

C, THF HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C. 

D, GO TO CHAPTER 2, USF PROCEDURES. 
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t.iJ LOAOING THL HSOP r^O^ilTOH 



THt HSOP MONITOH CAN HK LOADEH HY Mh ANS OF THE FOM hOOT WHICH SUft>UPTS 
THE HS^3 DISK. 

1,8,1 VIA THE POM BOOTS THAP LOADtH 



A. LOAD ANP WAIT UNTIL OplVI- ^^ IS PEADY, 
b, LOAD PPOPER R0« ADDRESS FOR THt PS411, 
C, PRESS START, 

1.8,2 COMMON PROCEDURE 



A. THE MONITOR IS LOADED FROM THE MEDIUM, 

h, THE MONITOR TYPES THE FOLLOWING *«FSSAGE AND IS THEN READY TO ACCEPT 
KEYBOARD COMMANDS. 

DZOUP»B 21-JUL-76 PSUP - RS04 MONITOR NNK 
RESTART AnnptX.XXXX.X 
BOOTED VIA UNIT»: ^ 

TO ABORT THE FOLLOrtiNG HELP MESSAGE TYPE CTRL C CO 
TYPE: 

F<CP> TO SET CONSOLE FILL COUNT 

D<CR> FOR DIBECTOFY ON CONSOLE, OB 

D/F<CR> FOP SHORT DIRECTORY ON CONSOLE, OR 

D/L<CP> FOR DIRECTORY ON LINE PRINTER, OR 

D/L/F<CP> FOR SHORT DIRECTORY ON LIME PRINTER, 

P COPY<CR> TO PUN COPY PROGRAM, 

R HLENAME<CR> TO RUN ANY OTHER PROGRAM, 

L FILENAME<CP> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADDR<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAME<CR> TO PUN A CHAIN, 

C FILENAME/QV<CR> TO RUN A CHAIN IN QUICK VERIFY MODE. 
REFER TO XXDP MANUAL MD-ll-DZQXA FOR ADDITIONAL HELP. 



WHERE: NNK IS THE SYSTEM STORAGE UP TO 28K. 

XXXXXX IS THE MONITORS RESTART ADDRESS. 

THE (,) INDICATES THE MONITOR IS READY TO ACCEPT CqMANDS. 

C, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C, 

D, GO TO SECTION 2, USE PROCEDURES. 
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1,9 LOADING THE RMDP MONITOR 



THE RMDP MONITOR MAY BE LOADED BY MEANS OF THE APPROPRIATE ROM 
BOOTSTRAP. ONCE THE RMDP MONITOR HAS BEEN BOOTED, IT TYPES THE 
FOLLOWING MESSAGE, AND TS THEN READY TO ACCEPT KEYBOARD COMMANDS, 

DZQUT-A 21-JUL-76 PMDP - RK06 MONITOR NNK 
RESTART ADDR:XXXXXX 
BOOTED VIA IINITP: 

TO ABORT THE FOLLOWING HELP MESSAGE TYPE CTRL C CO 
TYPE; 

F<CR> TO SET CONSOLE FILL COUNT 

0<CR> FOR DIRECTORY ON CONSOLE, OP 

D/F<CR> FOR SHORT DIRECTORY ON CONSOLE, OR 

D/L<CP> FOR DIPECTOPY ON LINE PRINTER, OR 

D/L/F<CR> FOR SHORT DIRECTORY ON LINE PRINTER, 

R COPY<CR> TO RUN COPY PROGRAM, 

R FILENAME<CR> TO RUN ANY OTHER PROGRAM. 

L FILFNAME<CK> TO LOAD A PROGRAM ONLY 

S<CR> TO START THE PROGRAM JUST LOADED, 

S ADOP<CR> TO START THE PROGRAM AT SPECIFIC ADDRESS 

C FILENAME<CR> TO RUN A CHAIN, 

C F1LENAMF/QV<CR> TO PUN A CHAIN IN QUICK VERIFY "ODE, 
REFER TO XXDP MANUAL MD-11-DF.QXA FOR ADDITIONAL HELP, 



WHERE: NNK IS THE SYSTEM STORAGE UP TO 2«K, 

XXXXXX IS THE MONITORS RESTART ADDRESS, 

THE (,) INDICATES THE MONITOR IS READY TO ACCEPT COMAMDS, 
NOTE, THE HELP MESSAGE MAY BE ELIMINATED BY TYPING CTL C, 



GO TO SECTION 2. USE PROCEDURES, 
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2.1 



USE PROCEDURES 



THE USE PPOCEDURES THAT KOLLOU APPtY TO ALL XXUP MONITORS 
EXCEPT FOR THE TADP MONITOR WHICH PROVIDES SLIGHTLY MUDIHEU 
OPEPA;riONS, PEFEh TO SECTION 2.5 TADP MOMTOP EXCEPTIONS, 



SET THE P ILL COUNT 



THE TTY OUTPUT ROUTINE Of THE UPDATE PROGRAM NORMALLY OUTPUTS 

14(8) FILLER CHARACTERS AFTER A CARRIAGE RETURN, IN ORDER TO INSURE 

THAT THE LA30S TERMINAL PRINTS CORRECTLY, HOWEVER, ON TERMINALS OTHER 

THAT THE LA30S THE FILLER CHARACTERS ARE .40T REQUIRED AND ARE TIME 

CONSUMHING AND ANNOYING, THE NUMBER OF FILLER CHARACTERS OUTPUT CAN 

BE CHANGED BY MEANS OF THE "F" COMMAND, THE F COMMAND SHOULD 

BE THE FIRST COMMAND ISSUED IN ORDER TO PROPERLY SET UP THE CONSOL, TYPE: 



F<CP> 



000014 



;THE 000014 IS TYPED BY THE PROGRAM AND 

; INDICATES THE CURRENT FILLER COUMT. THE 1 

{iNDiCATtS THE uStP TYPED A FILLER COUNT OF 1, 



OBTAINING A DIRECTORY 



TO OBTAIN A DIRECTORY TYPE ONE OF THE FOLLOWING: 



D<CR> 



TO OBTAIN DIRECTORY ON CONSOLE TERMINAL, OR 



D/F<CR> 



TO OBTAIN SHORT DIRECTORY ON CONSOLE TERMINAL, 



D/L<CP> 



TO OBTAIN DIRECTORY ON LINE PRINTER, LINE PRINTER 
MUST BE PRESENT ON SYSTEM, NO CHECK IS MADE FOR IT, 



THE DIRECTORY CONTAINS THE FOLLOWING INFORMATION: 



FILNAM.EXT 



PROGRAM NAME AND EXTENSION ASSIGNED, ,BIN,.B1C, 
AND ,SAV, ARE THE ONLY VALID EXTENSIONS FOR 
XXDP MONITOR USE, 



NOTE: 



.BIN IS A BINARY FILE 

,BIC IS A CHAINABLE BINARY FILE 

.SAV IS A CORE IMAGE FILE, 



LENGTH 



NUMBER OF BLOCKS USED, DECIMAL NUMBER, (DISK AND DECTAPE ONLY), 



START 



STARTING BLOCK NUMBER. OCTAL NUMBER, (DISK AND DECTAPE ONLY), 



DATE 



DATE WHEN PROGRAM WAS PUT ON MEDIUM, 
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2.3 LOADING AND RUNNING PROGRAMS 



A. TYPE "R" AND THE PROGRAM NAME (UP TO 6 CHARACTERS). DO NOT TYPE THE 
EXTENSION ( .BIN, .BIO , 

THIS WILL LOAD AND RUN THE PROGRAM. TO JUST LOAD THE PROGRAM 
TYPE "L" AND THE PROGRAM NAME. ONCE LOADED TYPING A »S" 
WILL START THE PROGRAM. 

B. DEPRESS THE CTL AND G KEYS. 

IF A TYPING ERROR IS MADE, DEPRESS THE CTRL AND C KEYS AT SAME TIME. 
A DOT (.) WILL BE TYPED, RETYPE "R" AND THE PROGRAM NAME. 

C. THE DESIRED PROGRAM IS LOADED, A DOT TYPED, AND, 

1, THE PROGRAM SELF STARTS IF IT IS SELF STARTING, OR 

2, THE PROGRAM IS STARTED AT LOC 000200 IF THE PROGRAM NAME WAS 
ENDED WITH AN ALTMODE CHARACTER, OR 

3, THE MONITOR WAITS FOR ANOTHER COMMAND, THE PROGRAM JUST LOADED 
MUST BE STARTED MANUALLY BY TYPING S PROGRAM NAME <CR>. 

D. TO LOAD ANOTHER PROGRAM AFTER RUNNING THE PREVIOUSLY LOADED PROGRAM, 
RESTART THE MONITOR AT THE RESTART ADDRESS, OR RELOAD THE MONITOR 

AS DESCRIBED IN CHAPTER 1. 

E. POSSIBLE ERRORS ARE DESCRIBED IN CHAPTER 3. 

CAUTION! WHEN LOADING DIAGNOSTICS THAT TEST THE XXDP MEDIUM CARE MUST 
BE TAKEN TO INSURE THAT THE MEDIUM IS NOT ACCIDENTALLY 
DESTROYED, THAT IS THE REASON THAT THE MEDIUM MUST BE WRlTE- 
LOCKED, REMOVE IT IF IT IS DESIRED TO TEST THAT DRIVE. 
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2,4 CHAIN MODF OPERATION 



CHAIN MODE OPEPATION CONSISTS OF IMF SEQUENTIAL EXECUTION OF PROGRAMS 
WITHOUT OPERATOR INTERVENTION, ONLV PROGRAMS THAT HAVE BEEN MODIFIED 
TO RUN IN CHAIN MODE CAN BE CHAINED, CHAINAbLF PROGRAMS ARE 
IDENTIFIED IN THE DIRECTORY BY THE EXTENSION .bIC. 
NOTE; ,BIC IS A CHAINABLE BINARY FILE, 

TO RUN CHAIN MODEr THE XXDP MONITOR REQUIRES A FILE INDICATING 
THE PROGRAMS TO RUN, AND THE NUMBER OF TIMES EACH PROGRAM MUST 
EXECUTE BEFORE GOING ON TO THE NEXT PROGRAM IN THE TABLE. 

A CHAIN FILE MAY BE GENERATED BY USING THE XTECO TEXT EDITOR, 
AND THE USFR "UST FUT A .CCC EXTENSION ON THE CHAIN FILE. 

TO SUMMARIZES 

1, CHAIN MODE FUNS CHAINABLE PROGRAMS ONLY, ( ,BIC EXTENSIONS). 

2, A CHAIN FILE INDICATES THE PROGRAMS TO RUN AND THEIR PASS COUNTS. 

3, ONLY PROGRAMS RESIDENT ON THE SAME MEDIUM DRIVE CAN BE CHAINED. 

4, THE CHAIN FILE MUST BE ON THE SAME MEDIUM \nnH A .CCC EXTENSION, 

NOTE: THE ,CGC EXTENSION INDICATES A CHAIN FILE 

CHAIN MODE IS ENTERED BY TYPING; 

C FILENAME<CK> (WHILE IN MONITOR MODE). 

WHERE: 

C IS THE "CHAIN" COMMAND 

FILENAME IS THE VALUE OF THE ASCII FILE THAT CONTAINS THE MONITOR 
COMMANDS TO BE EXECUTED. THE FILE MUST HAVE A " .CCC"EXTENSI0N . 
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2,4,1 MAKING A CHAIN ASCII FILE 



THE CHAIN ASCII FILE MAY BE CREATED BY PUNNING THE XTECO PROGRAM AND 
USING THE TEXT EDITOR TO CREATE THt ASCII CHAIN FILE, THE CHAIN FILE 
MAY CONTAIN ANY OF THE COMMANDS SUPPORTED UNDER THE XXDP MONITOR, THE 
COMMANDS IN THE ASCII FILE ARE EXECUTED IN THE ORDER IN wHlCH THEY ARE 
ENTERED AND RUN AS A BATCH MODE. 
EXAMPLE OF A CHAIN FILE; 



jCPU.CCC 

jTHIS CHAIN FILE EXERCISES THE XYZ PROCESSOR WITH T1-T13,. 



R D0AA/1000 
R D0BA/1000 
R D0CA/1000 
P D0DA/1000 
R D0EA/1000 
R D0FA/1000 
R D0GA/1000 
R D0HA/1000 
R D0JA/1000 
R D0KA/1000 
R D0LA/1000 
R D0MA/1000 
L D0NA 



RUN Tl 1000 TIMES<CR> 
RUN T2 1000 TIMES<CR> 
RUN T3 1000 TIMES<CR> 
RUN T4 1000 TIMES<CR> 
RUN T5 1000 TIHES<CR> 
PUN T6 1000 T1MES<CR> 
RUN T7 1000 TIMES<CR> 
RUN T8 1000 TIMES<CR> 
RUN T9 1000 TIHES<CR> 
RUN T10 1000 TIMES<CR> 
RUN Til 1000 TIMES<CR> 
RUN T12 1000 TIMES<CR> 
LOAD T13<CR> 



S/1000<CP> 
C CPU 



START IT, RUN 1000 TIMES<CR> 
RESUBMIT CHAIN FILE AGAIN, 
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2.4.2 RUNNING A Chklh 



TO EXECUTE A CHAIN FILE IHfc USEP TYPES; 

C tlLNAM<CR> OP 
C fILNAM/OV<CP> 

IN THE FIRST CASE THE PASS COUNT SPECIFIED IN THE CHAIN FILE 

IS USED BY THE XXOP MONITOR TO DETERMINE THE NUMbEP OF PASSES TO 

EXECUTE EACH PROGPAK.IN THE SECOND CASE THE PASS COUNT 

IS NOT USED AND EACH PROGRAM IS EXECUTED ONLY ONCE, THE /QV SWITCH 

PROVIDES A SiNGLt EXECUTION MODE OF OPERATION OR "QUICK VERIFY". 

THE CHAIN FILE TO BE EXECUTED MUST HAVE AN EXTEfJSION OF .CCC, 

THE CHAIN FILE AND THE OBJECTIVE PROGRAMS TO BE RUN MUST RESIDE IN 
THE SAME XXDF MEDIUM AND "UST BE MOUNTED ON DRIVE OF XXDP DEVICE 

WHEN IN CHAIN MODE SwiTCH REGISTER Op SOFTWARE SWITCH REGISTER SHOULD 
BE SET TO l'P>0000, 

THE XXOP MONITOR WILL TYPE FACH COMMAND THAT IT EVALUATES AND THEN 
PROCEED TO EXECUTE IT. 

IF THE MONITOR ENCOUNTERS A PROGRAM THAT DOES NOT HAVE A ,bIC 
EXTENSION IT TYPES "NEXFIL". THEN IF THE ERROR RESULTED FROM A R 
tRUN COMMAND) ONLY, IT WILL CONTINUE talTH THE CHAIN FILE COMMAND, 
OTHERWISE IT TERMINATES THE CHAIN OPERATION. 

WHEN THE LAST COMMAND OTHER THAN ANOTHER "C" COMMAND HAS BEEN EXECUTED 

THE XXDP MONITOR TERMINATES CHAIN MODE AND TYPES A OOTC,), 
READY TO ACCEPT ANOTHER COMMAND FROM THE CONSOLE. 

IF THE USER WISHES TO TERMINATE CHAIN MODE BEFORE ITS NORMAL TERMINATION 
HE MAY DO SO BY REPEATEDLY TYPING CTL C ( *C ) AT THE CONSOLE UNTIL 
THE MONITOR ACCEPTS IT AT THE END OF A PROGRAM PASS. 
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2,5 TADP MONITOR EXCEPTIONS 



THE TADP PACKAGE CASSETTES ARE PACKAGED ACCORDING TO THE FOLLOwfING SCHEMES? 

1. ONE TADP CASSETTE CONTAINS THE TADP MONITOR AND XXDP UTILITIES 

(UPDI,UPD2r ETC) 

2. SEVERAL DIAGNOSTIC CASSETTES CONTAINING THE DIAGNOSTIC PROGRAMS. 

WHEN USING TADP, THE TADP CASSETTE MUST BE MOUNTED ON DRIVE 
(LEFT HAND DRIVE) OF THE TAllj THE DIAGNOSTIC CASSETTE IR MOUNTED 
ON DRIVE 1 (RIGHT HAND DRIVE), 

BECAUSE THE TADP PACKAGE IS A TWO DRIVE SYSTEM, TWO ADDlTIOhAL 
COMMANDS ARE PROVIDED THAT CONTROL THE DRiVF THAT IS TO BE ACCESSED,,- 

E 0<CR> {ENABLES ACCESS TO DRIVE 0, 

E 1<CR> jENABI.ES ACCESS TO DRIVE 1, 

WHEN THE TADP MONITOR IS FIRST LOADED IT DEFAULTS TO DRIVE 0, 
AT THAT POINT ALL COMMANDS GIVEN TO THE MONITOR APPLY TO DRIVE 
ONLY, 



TYPING E 1<CP> ENABLES ACCESS TO DRIVE 1 WITH ALL MONITOR COMMANDS 
APPLYING TO DRIVE 1, TO RETURM TO ACCESS DRIVE THE E 0<CR> 
COMMAND IS GIVEN. 



EXAMPLES; 



E 0<CR> 
D<CR> 
R UPD2 



•ENABLES DRIVE ACCESS, 

jOBTAINS DRIVF DIRECTORY, 

jPUNS UPD2 AFTER LOADING FROM DRIVE 0, 



E 1<CR> ;ENAHLES DRIVE 1 ACCESS, 

D/F<CR> JFAST DIRECTORY FROM DRIVE 1 

L ZTCAA0<CR> jLUADS 7.TCAA0 FRU'^ DRIVE 1. 

S 2C0<CP> jSTARTS 7TCAA0. 

E 0<CR> 'REENABLES DRIVE ACCESS. 



WHEN THE "D" (DIRECTORY) COMMAND IS GIVEN AMD DRIVK I IS ENABLED 
DRIVE WILL BE ACCESSED FIRST IN ORDER TO LOAD THF NON-RESIDENT 
DIRECTORY ROUTINE FROM THE TADP MONITOR ON DRIVE THEN DRIVE i 
IS ACCESSED TO OBTAIN DHlVt 1 DIRECTORY. 



IN CHAIN MODE THE CHAIN FILE IS ALvtAYS ACCFSStD FROM WHATEVER 
DRIVE WAS FNABLKD wHt^J THE "C" COMMAND ^.AS GIVEN, FVEN IF ThR 
CHAIN FILE ITSELF CAUSES ANQTHLR DRIVE TO BE ASSIGNED. 
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SEQ 0031 



EXAMPLE} 



C 



0<CP> 

CHAIN<CP> 



jDRiV'E twABLED, 

jPUN CHAIN FROM CHAIN, GCC (DRIVE 0), 



ASSUME CHAIN. CCC CONTAINS? 



E 
R 
R 
R 
R 
R 



1<CR> 

T1/10<CR> 

T2/10<CR> 



;ENABLE DRIVE 1 . 

jRUN Tl 10 TIMES, 

J PUN T2 10 TIMES. 
;RUN T3 



T3<CR> 
T4<CP> 
T5<CR> 



J P UN T4 
;PUN T5 



II 



n 



R 
E 



T90<CR> 
0<CR> 



;RUN T90 

;ENABLE DRIVE 0, 



THE CHAIN.CCC FILE MILL BE ACCESSED FROM DRIVE 0. ALL THE TEST 
PROGRAMS bILL BE ACCESSED FROM DRIVE 1. AT COMPLETION OF CHAIN 
DRIVE WILL BE ENABLED. 

NOTE THAT WITH TADp, CHAIN FILES DO NOT HAVE TO BE IN 
THE SAME CASSETTE AS THE TEST PROGRAMS, 

WHEN IN DOUBT AS TO WHAT DRIVE IS AVAILABLE THE USER JUST 
HAS TO GIVE THE COMMAND THAT ENABLES THE DRIVE HE WISHES TO 
USE, 



MAINDEC-ll-DZQXA«I-D XXDP USEP MANUAL 21 JULY 1976 MACYll 27(732) 24-JUN-7b 15:59 PAGE 32 

DZQXAI.Pl 1 



SEQ 0032 



3. ERRORS 



3.1 XXDP RESIDENT MONITOR ERRORS 



INVCMD/SW 

DEVERR 
EOM 

INVADR 

CKSMER 
POFLO 

INVNAH 
NEXFIL 



INVALID COMMAND ANO/OR SWITCH. CHECK COMMAND 
JUST GIVEN, 

DEVICE ERROR ON INPUT DEVICE, 

END OF MEDIUM, OCCURS DURING INPUT OPERATIONS 
WREN THE PROGRAM ATTEMPTS TO INPUT AND THE FILE 
IS AT AN END. SERIOUS PROBLEM. FILE IN STOR. 
AGE IS PROBABLY WIPED OUT. 

INVALID ADDRESS. MUST BE EVEN WITHIN EXISTING 
LOCORE AND HICORE LIMITS^ AND MUST NOT BE WITHIN 
UPDATE PROGRAM, 

CHECKSUM ERROR DURING "LOAD" COMMAND. 

PROGRAM TOO LARGE TO LOAD WITHIN EXISTING CORE 
SPACE. 

INVALID CHARACTER TYPED FOR FILE NAME. 

NON-EXISTENT FILE, IF IN CHAIN MODE 
THE PROGRAM TO BE RUN DOES NOT HAVE 
.BIC EXTENSION. 
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CHAPTER 3. XXDP UPDATE PROGRAMS II (UPOl) AND 12 (UP02) AND (UPl)2R) 



TABLE OF CONTi.NTS 

1, ABSTRACT 

2, REOUIREMENTS 

3, LOADING AND STARTING PPOCEDURE, 

4, COMMAND DESCRIPTIONS 

5, ERRORS 

6, UPDATING XXDP MEDIA 

7, ACT MODE OPERATION 
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SEO 0034 



1 , ABSTRACT 



EACH XXDP PACKAGF. CONTAINS imO PROGRAMS CALLED UPDl.BIN, AND UPD2.BIN, 
THESE PROGRAMS ARE USED TO ADD, DELETE, RENAME, OR PATCH PROGRAMS ON XXDP 
PACKAGES, AND IN GENERAL, PROVIDE FILE MAINTENANCE SERVICES. 

UPDl IS A 4K PROGRAM THAT RELOCATES ITSELF TO THE TOP 4K OF MEMORY, 
TO LEAVE LOWER STORAGE FREE FOR OTHER PROGRAMS. UPDl IS CAPABLE 
OF PERFORMING OPERATIONS ON FOUR XXDP MASS STORAGE DEVICES, PLUS 
PAPER TAPE. 

UPD2 IS A BK PROGRAM WHICH RELOCATES ITSELF TO THE TOP 8K OF 
MEMORY* LEAVING LOWER STORAGE FREE FOp OTHER PROGRAMS, IT IS 
CAPABLE OF PERFORMING OPERATIONS ON ALL XXDP MASS STORAGE DEVICES. 

UPDATE PROGRAM #2 IS AN EXPANSION OF UPDATE PROGRAM 11, IT INCLUDES 
ALL THE FEATURES OF UPDl, WITH ADDED FACILITIES FOR HANDLING AND 
CHECKING GROUPS OF FILES. THE ABILITY TO EXECUTE A COMMAND FILE, 
AND THE USE OF THE "ASTERISK" AND "WILD CHARACTER" CONSTRUCTIONS 
HAVE BEEN ADDED TO FACILITATE USER FILE STORAGE MANIPULATIONS. 

A THIRD UPDATE PROGRAM CALLED UPD2R IS AVAILABLE FOP DEC INTERNAL USE. 
ITS PURPOSE IS TO PROVIDE A FACILITIY FOR RELIABLE GENERATION OF XXDP 
PACKAGES BY THE RELEASE ENGINEERING GROUP OF DIAGNOSTIC ENGINEERING, 
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2, REQUIREMENTS 



2.1 THE rOLLO*iwG MINIMUM CONHGUPATION IS FtQUIPED TO HUN UPl»l: 

8K MEMORY 
CONSOLE TERMINAL 

XXUP INPUT MEDIUM FOR UPDl : (PKll, TCU* RXPl, TAll) 

2.2 THE FOLLOWltiG MINIMUM CONFIGURATION IS REQUIRED TO RUN UPD2 : 
FOLLOWING: 

12K OF MEMOPX 
CONSOLE TERMINAL 

1 OP MOPE XXDP MEDIA ( TC U , RK 1 1 , TA 1 1 , TMl 1 , TMM2 # RXll , HX V U , RSI 1 , 
RPII »TS0J,RP04,RK06) 

2.3 IN ORDER TO SUCCESSFULLY LOAD A PROGRAM USING THE UPDATE »! PROGRAM, ONE 

MUST HAVE AT LEAST 4K MORE STORAGE THAN THE LARGEST PROGRAM TO BE 
LOADED REQUIRES. UPD2 NEEDS &¥ MORE. 

2.4 WHEN THE USER IS TYPING A CORMAND OR DATA UNDER UPDI/UPD2, HE SHOULD 
BE AWARE OF THE FOLLOWING SPECIAL CHARACTERS! 

*C (CONTROL C) TAKES HIM TO COMHAND MODE, 

*Z (CONTROL Z) EXITS TEXT MODE, RETURNING TO COMMAND MODE 
RUBOUT - DELETES THE LAST CHAPACTEP. TYPED, 

THE ONLY OUTPUT AND INPUT FILE SPECIFICATION SEPARATOR CHARACTERS ARE: 

< (LEFT ANGLE BRACKET), (EQUAL SIGN) = AND _ (UNDERSCORE), 
LEADING SPACES ARE IGNORED. 

CARRIAGE RETURN IS THE ONLY LEGAL COMMAND TERMINATOR, EXCEPT IN THE 
CASE OF THE "MOD" AND "TEXT" COMMANDS, 

FILENAMES ARE CONSIDERED TO BE ALWAYS 6 CHARACTERS LONG, PLUS A 3 
CHARACTER EXTENSION, THE NAME AND EXTENSION ARE LEFT-JUSTif lED 
WITH TRAILING BLANKS. 

2.5 DEVICES SUPPORTED 



RKU, TAll, PTH, TCU, RPll, RP04, RSll, TMU, TM02, RXJl, 
PXVll, TS03, RK06 
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3. LOADING AND STARTING PPOCEOURE 



UPDi/UPD2 IS LOADED VIA THE XXDP MQNITOP BY TYPING P l!PDl<CR>/B UPD2<CR>. 
ONCE LOADED, IT OUTPUTS THE FOLLOWING MESSAGE! 

DZQUA-I - XXDP UPDATE PROGRAM il 21-JUL-76 
DATE; 

OP 

DEQUB-I - XXDP UPDATE PROGRAM 12 2i-JUL-76 
DATE! 



TYPE THE DATE ACCORDING TO FOLLOWING FORMAT: 
DATE:DD-MMM-YY<CR> 

DD IS THE DAY OF THE MONTH, MMM IS JAN, FEB, MAR, APR, MAY, 
JUN, JUL, AUG, SEP, OCT, NOV, DEC, AND YY IS BETwEEN 70 AND 99, 

TEST IS HADE TO MAKE SURE NO MONTH HAS MOPE THAN 31 DAYS. BUT 
DATES LIKE FEB 30, APR 31, ETC.* WILL NOT BE DETECTED AS ERRORS 
BUT WILL BE STORED AWAY AS FEB 30, APR 1, ETC, 

THE PROGRAM WILL TYPE BACK THE DATE FOLLOWED BY: 



PROGRAM RELOCATED TOrYYYYYY {INITIAL ADDR WHERE PROGRAM RELOCATED TO, 

RESTART! XXXXXX jUPDl RESTART ADDRESS, 

• INDICATES READY FOR KEYBOARD COMMANDS. 
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4, CGMMANU DESCPiPTIONS 



IN THE COMMAND DESCRIPTIONS THAT FOLLOW, AN iNOiCATIOKi iS PPOVIOEO 
AS TO THE AVAILABILITY OF THE COMMAND UNDEp UPDl OR UPD2. ALL COMMANDS 
APE AVAILABLE FOft UPD2. ONLY A SMALL SURSET IS AVAILABLE FOP UPOl . 
ALL COMMANDS DESCHIBED ARE PART OF THE UPD2R PROGRAM. COMMANDS THAT 
APE UNIQUE TO THE UPD2R PROGRAM ARF INDICATED. 



4.2 THE FILL COMMAND (UPDl, UPD2) 



THE CONSOLE TERMINAL OUTPUT ROUTINE OF THE UPDATE PROGRAM NORMALLY OUTPUTS 

14(8> FILLER CHARACTERS AFTER A CARRIAGE RETURN, IN ORDER TO INSURE 

THAT THE LA30 TERMINAL PRINTS CORRECTLY, HOtoEVER, ON TERMINALS OTHER 

THAN THE LA30 THE FILLER CHARACTERS ARE NOT REQUIRED AND ARE TIME 

CONSUMMING AND ANNOYING, THE NUMBER OF FILLER CHARACTERS OUTPUT CAN 

BE CHANGED BY «EANS OF THE "FILL" COMMAND, THE FILL COMMAND SHOULD 

BE THE FIRST COMMAND ISSUED IN ORDER TO PROPERLY SET UP THE CONSOLE. TYPE: 

FILL<CR> 

0^0014 1 ?THE 000014 IS TYPED BY THE PROGRAM AND 

I INDICATES THE GORPENT FILLER COUNT. THE 1 

J INDICATES THE USER TYPED A FILLER COUNT OF 1. 

THE FILLER COUNT SHOULD BE SET TO A 1 FOR ASR33 AND ASR35 TERMINALS. 
FOB OTHER TERMINALS, SET THE NUMBER TO WHATEVER PRODUCES CORRECT 
PRINTING AFTER A CARRIAGE RETURN, KITHOUT UNDUE DELAY. 

4.3 THE "CLR" COMMAND (UPD1,UPD2) 



THE -CLR" COMMAND IS USED TO CLEAR TO ZEROES ALL CORE STORAGE BELOhi 
THE UPDATE PROGRAM. IT IS PROVIDED IH CASE THE USER WISHES CORE 
STOPAGE TO BE "ZEROED" PRIOR TO LOADING A PROGRAM, TYPE: 

CLB<CR> 



THE PROGRAM RESPONDS WITH » 
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4,4 LOAD COMMAND (UPDlr UPD2) 



THE LOAD COMMAND IS USED TO LOAD FILES STOKED IN A6S FORMAT. 
(FILES WITH EXTENSIONS OF .BIN, ,BIC, OR OTHER EXTENSIONS KNOWN 
TO INDICATE ABS FORMAT), 



LOAD DEVJ FILNAM.EXT jCOMMANO FORMAT 

IF THE DEVICE HAS NO DIRECTORY, THEN THE FILE NAME AND EXTENSION 
SHOULD BE OMITTED. 

LOAD PR: J USER COMMAND TO LOAD FROM PAPER TAPE. 

XFPADRJ 00(11050 COPE! 000000,017670 



XFRADP! INDICATES THE STARTING ADDRESS OF THE PROGRAM LOADED. IF 
IT IS 000001 OP ODD, THE PROGRAM IS NOT SELF-STARTING, 

CORE: LEFT NUMBER INDICATES THE LOWEST LOCATION LOADED INTO DURING 
THE LOAD. THE RIGHT NUMBER INDICATES THE HIGHEST LOCATION 
LOADED INTO DURING THE LOAD, THE LEFT AND RIGHT NUMoERS 
IN EFFECT INDICATE THE CORE LIMITS OF THE PROGRAM, 



4.5 DUMP COMMAND (UPD1»UPD2) 



THE MEMOFY CONTENTS CAN BE WRITTEN TO A XXDp MEDIUM IN ABS FORMAT BY THE 
DUMP COMMAND. 



DUMP DEV: FILNAM.EXT jCOMMAND FORMAT 

PROCESSING STARTS FROM PROGRAM'S LOW CORK LIMIT AND PROCEEDS TO B«IT DOES 
NOT INCLUDE THE PROGRAM'S HIGH CORE LIMIT. 

•DUMP DK0:XXX.BIN ;DUMP PROGRAM ONTO DK0!. CALL 11 XXX.BIN 

»OIR 



12-JAN-76 

ENTRYf FILHAM .F.XT DATE LENGTH START 

000001 XXX .BIN 2b-AUG-72 17 V^(iiV5 

000002 2 2-AUG-72 1 2C 000172 

000003 3 2-AUG-72 I 2C 00020b 
FREE files: 445 



« 
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4.6 THE "XFP" COMMAND (UPDl, UP02) 



ONCE A PROGRAM HAS BEEN LOADED INTO CORE VIA THE "LOAD" COMMAND, IT 
CAN BE MADE SELF-START IMG OR NOT SELF-STARTING AT THE USER'S DISCRETION*. 
AS DESCRIBED UNDER "LOAD COMMAND", THE LOAD ROUTINE TYPES: XFRADR :XXXXXX 
INDICATING WHETHER A PROGRAM IS OR IS NOT SELF-STARTING. THE USE Of "XFR" 

XFR<CP> ; REQUEST CURRENT TRANSFER ADDRESS. 

000056> ;000001 IS THE CURRENT XFP ADDRESS, 000050 IS THE 
;NEW XFP ADDRESS ENTERED BY THE USER. 

NOTE; DIAGNOSTIC PROGRAMS ARE PURPOSELY MADE NOT SELF-STARTING, 



4,7 THE "START" COMMAND (UPDl, UPD?) 



THE "START" COMMAND IS USED TO BEGIN EXECUTION OF A PROGRAM IN CORE. 

START<CR> lUSED TO START A SELF-STARTING PROGRAM, 

START AOR<CR> jUSED TO A START A PROGRAM AT A SPECIFIC LOCATION. 

NOTE* IF THE COMMAND START<CR> IS GIVEN FOR A NON-SELF-START PROGRAM, 
THE PROCESSOR WILL TRAP OUT WITHOUT AM ERROR MESSAGE, 
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SEQ 0040 



4,8 



THE SAVE COWMAND 



(UPDl, UPD2) 



THE CONTENTS OF CORE ABE WRITTEN ONTO THE OUTPUT DEVICE AS A SINGLE 
BLOCK OF DATA, STARTING AT LOC AND PROCEEDING TO THE HIGH 

LIMIT OF THE PROGRAM IN COPE, THE SAVE COMMAND IN EFFECT, SAVES 
A "CORE IMAGE" OF THE CONTENTS OF CORE. FOR XXDP PURPOSES THE ONLY 
VALID EXTENSION FOR SAVED PROGRAMS IS .SAV. 

THE ONLY CURRENT USE OF THE SAVE COMMAND IS TO 
PLACE A CORE IMAGE OF THE XXDP MONITOR ON CASSETTE 
AND MAGTAPE. XXDP PACKAGES DO NOT CONTAIN ANY OTHER 
COPE IMAGE FILES 

NOTE; ,SAV IS A CORE IMAGE FILE. 

SAVE DEVj FILNAM.EXT jCOMMAND FORMAT. 

•SAVE DK0t UPDATE. SAV 
•DIR DK0: 



12-JAM-76 
ENTRY! 
000001 

000002 2 

000003 UPDATE 
FREE FILES; 445 



FILNAM ,EXT 
UPDATE .BIN 



.SAV 



DATE 

26-AUG-72 
2-AUG-72 
26-AUG-72 



LENGTH 
17 
12C 
12C 



START 
000105 
0(30172 
000247 



4.9 



THE GET COMMAND (UPD2 ONLY) 



THE GET COMMAND PLACES THE "SAVED" PROGRAM INTO CORE STARTING AT LOC 000000, 
GET DEV:FILNAM,EXT 



•GET DK0JUPDATE.SAV 
• 

NOTE; SAVE CORE IMAGE FILES (.SAV FILES) ARE NO 
LONGER IN USE, THE "GET" COMMAND IS NO 
LONGER VERY USEFUL, IT HAS BEEN LEFT AS 
THE COMPLEMENTARY COMMAND FOP THE SAVE COMMAND. 
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4.1kJ THE MOO COWHAND (UPDl, UPD2) 



ONCE A PPOGPA*? Is LOADED IT CAn BE PATCHED bi THE MOD COMMAND, 



MOD ADB CAUSES UPDATE TO PRINT THE FOLLOWING: 

ADFI COM TENTS Of ADP, 

AND WAITS FOR USER RESPONSE. 

THE USER MAY TYPE IN AN OCTAL NUMBER AND A TERMINATOR, Op JUST 
A TERMINATOR, 

IF A NUMBER IS TYPED, IT IS USED AS THE NEW CONTENT OF ADR. 

THE TERMINATOR CAN BE EITHER A CARRIAGE RETURN OR A LINE FEED, 
CARRIAGE BETURK TAKES THF. PROGRAM BACK TG COMMAND MODE, WHEREAS 
THE LINE FEED CAUSES THE NEXT WORD (AOR+2) TO BE OPENED FOR 
MODIFICATION 

*MOD 50 

0000S0 060005 3 <LF> 

000052 0l27i1 4 <LF> 

000054 000340 5 <CR> 
•MOD 50 

000050 00000 3 <LF> 

000052 000004 <CR> 



THE MOO COMMAND WILL NOT ALLOW THE USER TO GO BEYOND THE PROGRAM'S 
PROTECTIOH LIMIT, AN "INVCOR" ERROR WILL OCCUR, (SEE SECTION 4,13) 



4,10,1 THE HODALL COMMAND 



THE HODALL COMMANDS FUNCTIONS EXACTLY AS THE MOD COMMAND, BUT ALLOWS 
MODIFICATION OF ANY LOCATION, EVE« THOSE OUTSIDE THE LOW AND HIGH 
CORE LiMItS. 

EXAMPLE: 



MOOALL 177740 
177749 000010 4 



jMODlFIES LOCATION IN I/O PAGE, 
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4,11 THE CORE COMMAND {UPDl, UPD2) 



THE CORE COMMAND CAUSES THE LOWER AND UPPER LIMITS OF THE PROGRAM 
IN CORE TO BE TYPED* 

•CORE<CR> 

00»000,C»14776 J LEFT NUMBER IS THE LOWER CORE LIMIT, 

;RIGHT NUMBER IS THE UPPER CORE LIMIT. 

4.12 THE "LOCORE" COMMAND (UPDl, UPD2) 



THE "LOCORfc" COMMAND IS USED TO CHANGE THE LOWER LIMIT OF THE PROGRAM IN CORE; 

•LOCORE AOR<CR> jWHEPE ADR IS THE NEW LOW CORE LIMIT. IT IS RECOMMENDED 

•THAT ADDRESS BE EVEN. 

4,13 THE "HICORE" COMMAND CUPDl, UPD2) 



THE "HICORE" COMMAND IS USED TO CHANGE THE UPPER LIMIT OF THE PROGRAM IN COPE: 

•HICORE ADP<CP> JWHEPE ADR IS THE NEW HIGH CORE LIMIT, RECOMMEND THAT 

.•ADDRESS BE EVEN, BUT MUST BE HIGHER THAN THE LOWER 
;LIMIT, AND MUST BE LOWER THAN START OF UPDATE PROGRAM, 

TYPICALLY, THE HICORE COMMAND IS USED TO RESERVE AN AREA FOP PATCHING 

A PROGRAM, THE UPDATE PROGPAM WILL NOT ALLOW MODIFICATION OF CORE BELOW THE 

LOW CORE LIMIT, AND WILL NOT ALLOW MODIFICATION OF LOCATIONS mHOsE 

ADDRESS IS EQUAL OR HIGHER THAN THE HIGH CORE LIMIT. THEREFORE, wHEN 

ADDING A PATCH, THE HIGH CORE LIMIT MUST BE SET SUFFICIENTLY HIGH SO 

AS TO INCLUDE THE COMPLETE PATCH, 
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4,14 THt DIPLP AND DlH COMMANDS 



DIP (UPbl, UPD2) 

DIRLP (UP02 ONLY) 

»DIRLP DFV: .'COMMAND FORMAT 

COMMAND EXAMpLLSj 

UPD1#AND UPD2 



•DIP DEV: 
UPD2 ONLY 



#DIR DEV:»,&IN 



«DIR DEVl«.BI? 



DIP DEV!ZTe???.BI? 



IHIS GIVES AN ENTIRE DIRECTORY Of THE DEVICE, 



jGIVES A DIRECTORY OF ALL FILES 
WITH A ".BIN" EXTENSION, 
jGIVES A DIRECTORY OF ALL FILES 
bITH AN EXTENSION BEGINING WITH 
"BI" AND ANY OTHER CHARACTER 
SUCH AS BIN OR BIC, 
;GIVES A DIRECTORY OF ALL FILES 
WITH THE FIRST THREE CHARACTERS 
OF THE FILENAME BEING "ETC" 
AND HAVING AN EXTENSION BEGINING 
WITH "BI", EXAMPLES: ZTCA.BIN, 
ZTCB.BIN, ZTGCBIC, 
NOtEs AT THE END OF THE DIRECTORY THE FREE FILES AMD FREE BLOCKS WILL BE 
INDICATED ONLY ON RANDOM ACCESS DEVICES, 



NOTE: DIP IN UPDATE 11 GIVES ONLY THE SHORT DIRECTORY (NO LENGTH, NO START J 



DIRLP CAUSES THE DIRECTORY OF DEV: TO PRINTED ON LINE PRINTER. IF 
DiR Is USED, THE DIRECTORY IS TYPED ON CONSOLE DEVICE, DO NOT USE 
DiRLP UNLESS A LINE PRINTER EXISTS, AS NO CHECK IS MADE FOR ITS 
EXISTENCE. THE PROGRAM WILL PROBABLY TRAP, 



»DIR DK0: 

l2-JftN-76 

ENTRY* 

000001 

000002 

000003 

000004 

FREE FILES: 



FILNAM 

1 

2 

3 

5 



.EXT 



DATE 

2-AUG-72 
2-AUG>72 
2-AUG-72 
2-AUG-72 



LENGTH 

14 

12C 

12C 

12C 



START 

000105 

000172 

000206 

000222 



444 



LENGTH IS THE NUMBER OF BLOCKS (10) THE FILE OCCUPIES. A 
THE FILE LENGTH INDICATES THE FILE IS CONTIGUOUS. 



AFTER 



START IS THE ADDR OF FIRST BLOCK OF FILE, OCTAL NUMBER, 
DATE IS THE FILE CREATION DATE. 
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4,15 THE DELETE COMMAND (UPDl, UPD2) 



DEL DEV:FILNAM.EXT 

CAUSES THE FILE NAMED TO BE DELETED FROM THE DIRECTORY, 

•DEL DK0:1 
«DIR DK0: 

12-JAN-76 

ENTRY* FILNAM ,EXT DATE LENGTH START 

000002 2 2-AUG-72 I 2C 000172 

000003 3 2-AUG-72 12C 000206 

000004 5 2-AUG-72 12C 000222 
FREE FILES; 444 

• 
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4.t6 THE 2EP0 COMMAND (UPDl, UPD2} 



ZERO DEV: 

DESTROYS THE DlHECTORY. AS FAR AS UPDATE IS CONCERNED, THERE IS 
NOTHING ON THE DEVICE. THIS SHOULD HE DOn»E ON A BRAND tJE« TAPE 
OR CARTRIDGE SINCE UPDATE USES THE ZERO COMMAND 10 RESERVE S0»1E 
ROOM EOR USE BY THE XXDP MONITOR. VALID FOR ALL MASS STORAGE DEVICES. 

•ZERO DK0: 
«DIR DK0: 

26.AUG-72 

FILNAM.EXT LENGTH START DATE 

FREE FILES! 448 
• 

NOTE!'" WHEN THE DEVICE BEING ZEROED IS THE RK0b DISK, THE UPD2 AND 
UPD2R PROGRAMS WILL OUTPUT ONE Of THE FOLLOWING MESSAGESt 

NB6KS JRK06 ZEROED CONTAINS NO MANUFACTURING DETECTED 

SBAO BLOCKS AS PER BAD BLOCK FILE. 



SBKS 



jRK@fe ZEROED CONTAINS MANUFACTURING DETECTED 
?BAD BLOCKS AS PER BAD BLOCK FILE, 
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4,17 THE BOOT AND SAVM. (UpDl, UPD2) 

4,17,1 BOOT DEV: 

CAUSES BLOCK OF DEV TO BE LOADED INTO MEHORlf, STARTING AT LOC 00000P). 
BLOCK IS ASSUMED TO HAVE A BOOT LOADER, THE PROGRAM THEN JUMPS TO 
LOC 000000 TO START THE BOOT LOADER, 

EXAMPLE: 



BOOT 


DT0:<CR> 


; BOOTS 


IN 


THE 


TCDP 


MONITOR, 


BOOT 


DK0:<CR> 


; BOOTS 


IN 


THE 


RKDP 


MONITOR, 


BOOT 


MT0:<CR> 


J BOOTS 


IN 


THE 


TMDP 


MONITOR, 


BOOT 


CT0:<CR> 


; BOOTS 


IN 


THE 


TADP 


MONITOR. 


BOOT 


HM0:<CR> 


J BOOTS 


IN 


THE 


THDP 


MONITOR, 


BOOT 


DX0:<CR> 


; BOOTS 


IN 


THE 


RXDP 


MONITOR. 


BOOT 


DP0;<CR> 


y BOOTS 


IN 


THE 


RPDP 


MONITOR. 


BOOT 


DB0:<CR> 


jBOOTS 


IN 


THE 


KBDP 


MONITOR, 


BOOT 


DS0:<CR> 


; BOOTS 


IN 


THE 


R5DP 


MONITOR, 



4,17,2 SAVM DEV: 

CAUSES THE FIRST 4K TO BE WRITTEN IN ,SAV FORMAT (CORE IMAGE) 
STARTING AT THE MONITOR COpE IMAGE BLOCK OF THE DEVICE, 
THIS COMMAND IS USED TO wRITE THE XXDP MONITOR ON THE 
DEVICE AS A COPE IMAGE THAT IS BOOTABLE, 

♦LOAD DK1:PKDP,BIN jLOAD RKDP MONITOR. 

»SAVM DK0; fSAVE IT AS CORE IMAGE ON DK0: 

THE SAVM COMMAND IS VALID ONLY ON RANDOM ACCESS DEVICES, 



NOTE: 

ON 



SAVM IS NOT A DIRECTORY ENTRY IT WILL NOT SHOw 
DIRECTORY, 
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4.18 



THE HENAWE COMMAND 



(UPDl, IIPD2) 



#REN DEV ;NEWWAM , EXT-DEV : OLDHAM , EXT 

RENAMES THt OLD FILE. THfc: DEVICES MUST BE THE SAME. NOT ALLOwEO 
ON MAGTAPE Of? CASSETTE, 

»OIR DK0: 

12-JAN-76 

ENTR¥» FILNAH .EXT DATE LENGTH START 

&mmi A5D .121 26oAUG-76 IbC 0i)0t05 

FREE FILtSS 447 



«REN DK0: 12 j.ASD.DK0:ASO.123 
•DXR DK0: 



12-JAN-7fe 

ENTftifl 
00000 1 

FREE FILES* 447 



FILNAH .EXT 
123 .ASO 



DATE 
26-AUG 



LENGTH 
16C 



START 
000105 
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SEQ 0048 



4.19 PIP COMMAND (UPDl, UP02) 



Pip IS USED TO COPY A LINKED FILE FROM ANY DEVICE THAT CAN INPUT 

TO ANY DEVICE THAT CAN PERFORM OUTPUT OPERATIONS, FILE DATA IS 

NOT CHECKED FOR FORMAT OR CHECKSUMS. THE OUTPUT FILE IS GIVEN TODAY'S DATE, 

AND NOT THE DATE OF THE INPUT FILE, 

PIP DEVI :F1LNAM.EXT.DEV2!FILNAM.EXT 

PIP pp:«pr: (copies paper tape) 

«P1P 0K»U23.456<PR! jPAPER TAPE TO DISK 

•PIP PPJ<DK0! 123.456 »DISK TO PAPER TAPE PUNCH. 

•DIR DK0t 



12-JAN-76 
ENTRY! 
000001 
000002 
FREE FILES: 



446 



FILNAH ,EXT 
123 .ASD 
123 ,456 



DATE 

26-AUG-72 
26-AUG-72 



LENGTH 
16C 
3 



START 

000105 

000125 



THE USER SHOULD HAKE SURE THAT THE OUTPUT FILE NAME DOESN'T EXIST 
ALREADY ON THE OUTPUT DEVICE DIRECTORY. 



PIP OK0:A.DK0:A 
DELOLD 



JIS A NO MO. 
fCAUSES THIS ERROR, DELETE OLD FILE 1ST, 



Pip HAS OTHER USEFUL FEATURES: 

PIP PP:-PR: COPIES A PAPER TAPE, 

IMPORTANT! J I 



A PROGRAM THAT HAS BEEN "PiPpED" TO A XXDP DEVICE 
MUST BE LOADED IMMEDIATELY VIA THE "LOAD" COMMAND 
TO INSURE THAT NO ERRORS HAVE OCCURRED DURING THE 
"PIP" COMMAND AS THE PIP COMMAND DOES NOT CHECKSUM 
INPUT DATAi 
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4,20 THE "FILE" COMMANDS {UP02 ONLY) 



UPD2 IfiCLUDES A GROUP OF COMMAnDS WKiCH CAN EXtCUTf (>W MULTIPLE 
FILES WITHOUT BEQUIRING THE NAME Of EACH FILE TO BE I MQ I VI D»f ALL Y 
LISTED If» THE COMMANO STRINGS. THESE ARE THE "FILE" COM^^AMDS, 
INCLUDING FILE, FILEF, FILEL, FILEG, FILED, AND FILET, FOLLOtelKG 
THIS GEHERAL DESCRIPTION, THEIR DIFfEREMCES rtILL BE INDIVIDUALLY 
EXPLAINED, NOTE THAT THE "FILE" COMMANDS IN GENERAL, CAN NOl BE USED 
WITH NON-DIRECTORY DEVICES (SUCH AS PR, PP, LP). 



THE "FILE" COMMANDS RECOGNIZE TWO SPECIAL CHAPACIERS IN THE FILE NAME 
AMD EXTENSION, THESE CHARACTERS, THE ASTERISK {») A»D THE QUESTION- 
MARK (?) ALLOh A SINGLE NAME TO REFERENCE SEVERAL FILES, 

NOTE THAT FILE NAMES ARE ALWAYS RECORDED AS HAVING 6 CHARACTERS, 
AND EXTENSIONS ALIiiAYS HAVE 3 CHARACTERS. THEY ARE LEFT-JUSTIF lED 
WITH TRAILING BLANKS ADDED, AND THE BLANKS ARE PART OF THE NAME. 

BECAUSE THE "FILE" COMMANDS CAN HANDLE SEVERAL FILES PER COMMANu 
ISSUED, THEIR TREATMENT OF ERROR CONDITIONS SHOULD BE NOTED, IF A 
DEVICE ERROR OCCURS I** THE PROCESS OF FINDING A FILE (I.E, wHEN THE 
DIRECTORY IS REFERENCED IN THF CASE OF DISK OR DECTAPF., OR THt BLOCKS 
ARE SCANNED In THE CASE OF CASSETTE OR MAGTAPE), THE "FILL" COMMAND 
IS ABORTED AND THE ERROR Is PRINTED, IF A DEVICE ERROR, CHECKSUM 
ERROR, OR END OF MEDIUM ERROR OCCURS WHILE READING A FILE (FILEL, 
FILEG, AND FILET ONLY) THE ERROR IS REPORTED AND THEN PROCESSING 
OF THE COMMAND IS CONTINUED, 

THE "FILE" COMMANDS LIST THE DESCRIPTIVE INFORMATION ABOUT EACH 
FILE AS IT IS PROCESSED, INCLUDING FILE NAME, TRANSFER ADDRESS, 
AMD LGCORE AND HICOrE VALUES. THE /N AND /LP SWITCHES ARE INCLUDED 
TO ALTER THIS IF DESIRED, 
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4.21 THE "ASTERISK" CONSTRUCTION 



THE "ASTERISK" CONSTRUCTION PERMITS REFERENCE TO ALL FILES HAVING A 
DESIRED EXTENSION (ANY FILENAME), TO ALL FILES HAVING A DESIRED 
FILENAME (ANY EXTENSION), OR TO ALL FILES ON A DEVICE* ITS USE IN 
THE FILENAME POSITION MEANS "ANY FILENAME" AND IN THE FILE EXTENSION 
POSITION MEANS "ANY EXTENSION", 

TO REFER TO ALL FILES HAVING A DESIRED EXTENSION (ANY 
FILENAME), AN ASTERISK IS TYPED FOR THE FILENAME: 

DK0;*.OBJ MEANS ALL FILES ON DISK WITH 

A .OBJ EXTENSION 

DT3:»,Pn MEANS ALL FILES ON DECTAPE 3 WITH 

THE EXTENSION ,P11 

TO REFER TO ALL FILES WITH A DESIRED FILENAME (ANY EXTENSION), 
AN ASTERISK IS TYPED FOP THE EXTENSION: 

DK0;UPD2,» MEANS ALL FILES ON DISK WITH THE 

FILENAME UPD2, SUCH AS UPD2,P11, 
UP02.LST, AND UPD2,D0C 

DTl:SYSTST,» MEANS ALL FILES ON DECTAPE 1 wITH 
THE FILENAME SYSTST, SUCH AS 
SYSTST.Vl ,SYSTST,LST, AND SYSTST. ORJ 

TO REFER TO ALL FILES ON A DEVICE (ANy FILENAME, ANY EXTENSIO^), 
ASTERISKS APE TYPED FOR BOTH THE FILENAME AND THE EXTENSION: 

MT3:».» MEANS ALL FILES ON MAGTAPE 3 



CT0:»,» 



MEANS ALL FILES ON CASSETTE H 
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4,22 THE "WILD CHARACTER" CONSTRUCTION 



THE "WILD CHARACTER" CONSTRUCTION PERMITS PfcTbPKNCE TO ALL FlLfcS 
WHOSE FILE NAMES DIFFEP IN SPECIFIC CHARACTER POSITIONS. WHEH 
SEARCHING FOR FILES CORRESPONDING TO THt NAME IN THE COKMANO STFIWG, 
ANY CHARACTER IS ACCEPTED AS MATCHING A OUESTION MARK, FOR EXAMPLE: 



DK0:UPD?,OOC MEANS A«¥ FILE WHOSE NAME BEGINS WITH "UPO", 
HAS ANY CHAPACTFR NEXT (INCLUDING A BLANK) 
AND THEM TWO BLANKS, WITH A .DOC EXTENSION. 
UPOl ,DOC AND UPD2.D0G WOULD BOTH QUALIFY, 

DTI :TEST??,Pll WOULD INCLUDE ANY FILES ON DTI WHOSE FILENAMES 
BEGIN WITH "TEST" AND WHOSE EXTENSIONS ARE 
.Pll, SUCH AS TEST2.P11, TEST34,P11, AND 
TEST. PI 1 , 

CTl JSYSTST.V? INCLUDES ANY FILE ON CASSETTE 1 WHOSE FILENAME 
IS "SYSTST" AND WHOSE EXTENSION BEGINS WITH "V 
AND ENDS WITH A BLANK, THUS, SYSTST. V! AND 
SYSTST, VA WOULD QUALIFY, BUT SYSTST, V14 AND 
SYSTST, LST WOULD NOT, 
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4,23 THE FILE COMMAND (UPD2 ONLY) 



THE FILE COMMAND IS USED TO DO BULJ< TRANSFEPS FROM UNF DEVICE TO 
ANOTHER, IT IS SIMILAR TO A PIP COMMAND EXCEPT THAT IT CAN UTILIZE 
THE "ASTERISK" AND "WILD CHARACTER" CONSTRUCTIONS, IF A FILE OF THE 
SAME NAME ALREADY EXISTS ON THE OUTPUT DEVICE, THE FILE COMMAND 
(UNLIKE THE PIP COMMAND) WILL DELETE THE OLD FILE, NOTE ALSO THAT 
THE FILE COMMAND CAN TRANSFER BOTH LINKED AND CONTIGUOUS (CORE- 
IMAGE) FILES, THE OUTPUT FILE(S) IS GIVEN THE SAME DATE AS THE INPUT FILE(S). 

FILE DEV:<DEV:FILNAM,EXT jCOMMAND FORMAT 

WHERE THE DEVICE NAME ON THE LEFT IS THE OUTPUT DEVICE AND 
THAT ON THE RIGHT IS THE INPUT DEVICE, 



4,24 THE FILEF COMMAND (UPD2 ONLY) 



THE FILEF COMMAND IS USED TO DO FAST TRANSFERS ONTO ALL DIRECTORY DEVICES, 
FOR MAG TAPE LOGICAL END OF TAPE IS FOUND AND ALL THE REQUESTED 
FILES ARE TRANSFERRED SEQUENTIALLY ONTO THE TAPE STARTING AT THAT 
POINT, THIS FAST TRANSFER COMMAND ELIMINATES THE CHECK OF THE TARE 
DIRECTORY WHICH IS MADE BEFORE EACH FILE TRANSFER IF THE FILE COMMAND 
IS USED. 

FOR RANDOM ACCESS DEVICES THE FILE IS TRANSFERED TO THE FIRST 
AVAILABLE SPACE ON THE DEVICE. 



FILEF DEV:<DEV:FILNAM.EXT {COMMAND FORMAT 



4.25 THE FILED COMMAND (UPD2 ONLY) 



THE FILED COMMAND DELETES THE FILES NAMED FROM THE DEVICE'S DIRECTORY. 
FILED DEV:FILNAM,EXT 'COMMAND FORMAT 

UPD2 NOW PERMITS THE USE OF THE DEL{ETE) COMMAND wITH » AND iNlLD CHARACTER 
FILENAME CONSTRUCTION, EXAMPLF: 

DEL DK0:».BIN jDELETES ALL FILES IN DKp; wITH .BIN 

{EXTENSION. 

CAUTlONJil THE UPD2 PROGRAM DOES NOT REQUIRE VERIFICATION OF A MASS 

DELETION COMMAND. THE USER MUST BE CAREFUL NOT TO 
SPECIFY A DELETE THAT HE DOES NOT REALLY MEAN TO OCCUR. 
IF IT SHOULD* TYPING CONTROL C WILL ABORT THE COMMAND 
AT THE EARLIEST OPPORTUNITY. 
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4,26 THE FILEL COMMAND (UPD2 ONLY) 



THE FILEL GOHMAND SEQUENTIALLY LOADS i«TO CORE EACH FILE REFERENCEU. 
IT ASSUMES THAT ALL REFEHENCED FILES ARE ABS FORMAT (IF NOT A CKSMEH 
OR EOM ERROR WILL OCCUR), ITS PURPOSE IS TO SHOW THAT ALL AbS 
FORMATTED FILES CAN BE CORRECTLY LOADED (CHECKS FOR DFtflCF AND 
CHECKSUM ERRORS), IF AN ERROR OCCURS, IT WILL IDENTIFY THE UPE OF 
ERROR AND THE DEVICE. 

FILEL OEV:riLNAM.EXT jCOMHAMD FORMAT 

THE LOAD COMMAND MAY ALSO BE USED IN Up02 TO PERFORM THE SAME FUNCTIONS 
AS THE FILEL COMMAND. 

4.27 THE FILEG COMMAND (UPD2 ONLY) 



THE FILEG (FILE GET) COMMAND IS SIMILAR TO THE FILEL COMMAND EXCEPT 

THAT IT LOADS AND CHECKS CONTIGUOUS (CORE-IMAGE) FILES INSTEAD OF 

ABS FORMAT FILES, DEVICE ERRORS A«D SIZE ERRORS HILL BE REPUHTED. 

FILEG DEV:FILNAM.EXT {COMMAND FORMAT 

THE GET COMMAND MAY ALSO BE USED IN UPD2 TO PERFORM THE SAME FUNCTIONS 
AS THE FILEG COMMAND, 

4,28 THE FILET COMMAND (0PD2 ONLY) 



THE FILET COMMAND TESTS ALL FILES NAMED BY READING THEM INTO A BUFFER 
TO MAKE CERTAIN THAT NO DEVICE ERRORS OCCUR, ANY DEVICE ERRORS ARE 
LISTED AS THEY OCCUR, 

FILET DEVsFILNAM.EXT jCOMMAND FORMAT 

WHEN USED IN THE UPD2R PROGRAM, THE FILET OUTPUTS A MESSAGE INDICATING 
THE TOTAL NUMBER OF FILE BLOCKS PROCFSSED, 

«0F BLOCKS :XXXXX 

THIS FEATURE IS USEFUL TO RELEASE ENGINEERING IN DETERMINING THE TOTAL 
NUMBER OF BLOCKS WRITTEN IN A CASSETTE OR MAGTAPE, AS THEY MUST NOT 
USE UP MORE THAN 75 PERCENT OF THE MEDIUM, 
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4.29 THE /LP AND /N SWITCHES (UP02 ONLY) 



THE "FILE" COMMANDS NORMALLY CAUSE PRINTING OF THE NAMES OF THE FILES 

CHECKED, THEIR TRANSFER ADDRESSES, AND LOCORE AND HICORt VALUES, 

ON THE CONSOLE TERMINAL, THE /LP SWITCH CAUSES THIS INFORMATION TO BE 

OUTPUT ON THE LINE PRINTER INSTEAD, THE /N SWITCH INHIBITS PRINTING 

OF THIS INFORMATION, SO THAT ONLY ERROR PRINTOUTS ARE OUTPUT, SWITCHES MUST 

NOW BE SPECIFIED AT END OF THE COMMAND STRING, 

FILET DKfl:»,*/LP ;TEST ALL FILES ON DK0 AND PRINT 

jTHE FILE INFORMATION AND ERROR 
; INFORMATION ON THE LINE PRINTER 

FILEG DTl:»,SA?/N ;D0 A CORE-IMAGE LOAD OF ALL THE 

;,SAV FILES ON DECTAPE 1, 
.•REPORTING ONLY ERROR INFORMATION 

FILEL /N MT2:*,BIN/LP jLOAD ALL ,BIN FILES FROM MAGTAPE 2, 

;REPORTING ONLY ERROR INFORMATION 
;0N THE LINE PRINTER 

DEL DK0:«. TXT/LP ;DELETE ALL ,TXT FILES FROM DK0: AND 

•PRINT DELETED FILES ON LINE PRINTER. 

4,30 THE "EOT" COMMAND (UPn2 ONLY) 



THE "EOT" COMMAND IS PROVIDED AS A MEANS OF PLACING AN "END-OF^TAPE" 

HARK OR SENTINEL FILE AT A SELECTED SPOT ON MAGTAPE OR CASSETTE. APPLICATIONS 

OF THIS COMMAND INCLUDE REPLACING AN "EOT" MARK WHEN IT HAS BEEN 

ACCIDENTALLY DESTROYED, OR WHEN THE USER WISHES TO DELETE FILES Al THF 

END OF THE MEDIUM, AND STILL BE ABLE TP USE THE SPACE TAKEN UP BY 

THOSE DELETED FILES. 

THE PROCEDURE TO BF USED IS AS FOLLOWS: 

A. POSITION THE MAGTAPE BY PERFORMING A FILET COMMAND OH THE FILE 
PRECEDING THE SPOT WHERE THE "EOT" IS TO BE PLACED. IN PRACTICE, 
IF AN "EOT" HAS BEEN LOST, THE USER SHOULD FILET THE NEXT TO THE 
LAST FILE, SINCE THE LAST FILE MAY BE UNRECOVERABLE, 

B. PERFORM AN "EOT" COMMAND. 
EXAMPLE: 



• FILET MTf?: ZQRAD0.BIN<CP> 
#EOT<CR> 



jREADS FILE ZQRADfi.blf^ AND STOfS, 
{WRITES EOT. 
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4,31 THE TEXT COMMAND tUPU2 ONLY) 



UP02 INCLtlOES THE FACILITY TO EXECUTE A SEQUENCE OP COMMANDS 
(;njjT^T«po i« ^ti ASCII TEXT FILE, THIS ASCII TE!XT FILE IS CREATEO 
VIA THE TEXT COMMAND, ALSO SEE CHAPTER 4, XTECO TEXT EDITOR, 

TEXT DEV:f ILNAH.fcXT jCOMMAND FORMAT 

WHEN THE TEXT COMMAND IS ISSUED UPD2 OPENS THE NAMED FILE FOR 
OUTPUT AND RESPONDS WITH A OUOTATION MARK (") TO INDICATE ITS 
READINESS TO ACCEPT TEXT, ANY ASCII CHARACTER (EXCEPT CONTROL C AND 
RUBOUT) WILL BE ACCEPTED AS INPUT TO THE TEXT FILE. CONTROL C CO 
WILL ABORT TEXT MODE, RETURNING TO COMMAND MODE AND CLOSING 
THE OUTPUT FILE. CONTROL 2 CZ) IS THE STANDARD TERMINATOR FOR INPUT 
TO THE TEXT FILE, RUBOUT CAK BE USED TO DELETE CHARACTERS ON THE 
CURRENT LIME (BUT NOT ON PRECEDING LINES) . 

THREE CHARACTERS, THE POUND SIGN (I), THE SEMICOLON (•), AND THE DOLLAR 
SIGN (S) , HAVE SPECIAL SIGNIFICANCE IN THE TEXT FILE. THE « SIGN AMD ; ARE 
USED TO START A COMMENT WHICH IS TO BE PRINTED DURING COMMAND FILE 
EXECUTION. THE S SIGN IS USED TO START A COMMENT WHICH IS TO UE PRINTED 
AND FOLLOWED BY A HALT DURING COMMAND FILE EXECUTION (SUCH AS "SPRESS CONT 
WHEN READY"), 



4.32 THE PRINT COMMAND (»PD2 ONLY) 



THE PRINT COMMAND OUTPUTS A FILE ON THE LINE PRINTER, IT IS 

USED TO PRINT TEXT FILES, AND WILL OUTPUT TO THE LINE PRINTER, 

AFTER THE TEXT FILE IS PRINTED THE PROGRAM OUTPUTS 10 CARRIAGE RETURNS 

And LINE FEEDS TO SIMULATE A FqRM FEED, NOTE THAT BOTH PRInT AnD TYPE 

COMMANDS ACCEPT • AND WILD CHARACTER CONSTRUCTION IN FILENAMES, SO 

THAT MULTIPLE TEXT FILES MAY BE PRINTED WITH ONE COMMAND. 

PRINT DEVrFILNAM.EXT jCOMMAND FORMAT 

PRINT DEVJ»,TXT 

WHERE OEV IS THE SOURCE DEVICE ON WHICH THE FILE RESIDES. 
NOTE THAT NO CHECK IS MADE OF FILE PRINTAfllLITY . 



4,33 THE TYPE COMMAND (UP02 ONLY) 



SAME AS THE PRINT COMMAND EXCEPT THAT IT OUTPUTS TO THE CONSOLE 
TERMINAL INSTEAD OF TO THE LINE PRINTER, 



TYPE DEV:FILNAM.EXT 



{COMMAND FORMAT 
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4.34 



THE DO COMMAND (UPD2 ONLY) 



THt 00 COMMAND IS USED TO CAUSE THfc. EXECUTION OF A CO^'MAND FILE, 

THE FILE MUST BE ON ONE OF THE XXDP STORAGE MEDIA (DtCIAPE, MAGTAPE, 

CASSETTE, OR DISK). THE FILE IS EXECUTED LINE BY LINE, AND MUST 

BE TERMINATED BY A *Z (CONTROL Z). EXECUTABLE FILES ARE CREATED 

VIA THE TEXT COMMAND, OR VIA THE XTECO TEXT EDITOR PROGRAM (SEE CHAPTER 4.) 

FOR NOTES ON THE FILE'S FORMAT AND THE USE OF SPECIAL CHARACTERS, 

SEE THE PPECEEDING TEXT COMMAND DESCRIPTION, 

DO DEV:FILNAM,EXT 'COMMAND FORMAT 



THE ASG (ASSIGN) COMMAND ALLOWS THE USE OK LOGICAL DEVICE NAMES IN 
COMMAND FILES. ALLOWED LOGICAL DEVICE NAMES ARE 1,2,3,4, AND SYS, 
A COMMAND FILE "AY USE A LOGICAL NAME SUCH AS "1" INSTEAD OF 
SPECIFYING, FOR EXAMPLE, DK0 OR DKl, THEN, BEFORE EXECUTING 
THE COMMAND FILE, THE USER CAN ASSIGN THE DESIRED PHYSICAL DEVICE 
TO THE LOGICAL NAME, PERMITTING USE OF ANY AVAILABLE UNIT, 

ASG PHYSICAL DEV = LOGICAL DEV 'COMMAND FORMAT 



REVERSAL OF PHYSICAL AND LOGICAL DEVICE NAMES IN THE COMMAND STRING 
RESULTS IN "INVDEV" ERROR MESSAGE, THE COMMAND IS NOT PERFORMED, 



4.35 



THE ASG (ASSIGN) COMMAND 



(UPD2 ONLY) 



ASG DKl: 



2: 



jASSIGNS DISK 1 TO LOGICAL DEVICE "2" 



ASG DT3: 



SYS: yAsSlGNS DECTAPE 3 TO LOGICAL DEVICE 



"SYS" 
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4,36 THE FILCMP COMMAKD (UPD2P ONLY) 



THE FILCMp COHHAND IS USED TO COMPARE TWO FILES WHICH ARE THE SAME 

BUT ON DIFFEBENT XXllP DhIvES Ob OirFEPEwT XXDP MEDIUMS, IT CA«i UTILIZE 

THE "ASTERISK" AND -WILD CHAHACTER" CONSTPUCTIONS . 

FILCHP D£Vj<DEV:F1LNAH.EXT ;G0MMAND FOPMAT, 

WHERE THE FILE ON THE DEVICE ON THE RIGHT IS COMPARED TO THE FILE 
OF THE SAME NAHE ON THE DEVICE ON THE LEFT, 

EXAMPLE} 

FILCHP DKls<OIC0:»,» jCQMPAPES ALL FILES ON DISK TO 

rALL FILES ON DISK 1, 



FOP ERRORS UNIQUE TO THE FILCMp COMMAND SEE CHAPTER 5.1, 
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4,37 THE PATCH COMMAND (UPD2) 



THE PATCH COMMAND ENABLES THE USER TO PATCH A PROGRAM ON ANY DIRECTORY- 
ORIENTED (RANDOM ACCESS) XXDP SUPPORTED DEVICE, NO OUTPUT 
DEV: FILE SPECIFICATION IS REQUIRED OR PERMITTED, THE INPUT DEVICE 
IS ASSUMED TO BE THE DESIRED OUTPUT DEVICE. 

THE EILE(S) TO BF PATCHED MUST BE IN ABS FORMAT 

BINARY FILE, THE PATCH ROUTINE DOES NOT CHECK IN ADVANCE 

FOR CORRECT FILE FORMAT. THE FOLLOWING EXTENSION 

ARE FOR XXDP ABS FORMAT FILES; .BIN, ,BIC, .MpG. 



CARRIAGE-RETURN OR LINE-FEED ARE THE ONLY CHARACTERS WHICH MAY BE USED 

FOR TERMINATING A TYPED ENTRY. THE LINE-FEED MAY BE THOUGHT OF AS AN 

"ADVANCE" KEY, WHICH HILL GO TO THE NEXT ADDRESS. THE RUbOUT KEY MAY 

BE USED TO CORRECT TYPING MISTAKES MADE ON INPUT, ALL ADDRESSES ENTERED MUST 

RE EVEN, IF AN ADDRESS IS TYPED (IN RtSPONSE TO A PROMPT) WHICH IS ODD, TFE 

PROMPT WILL BE RE-ASKED. 

IF AN ADDRESS IS TYPED WHICH IS NOT WITHIN THE CORE LOAD LIMITS OF THE FILE 
BEING OPERATED UPON, THE UNKNOWN CONTENTS OF THE SPECIFIED ADDRESS WILL 
BE INDICATED BY "XXXXXX", THE PROGRAM WILL THEN GIVE THE USUAL "?" 
PROMPT, ASKING IF MODIFICATION IS DESIRED. 

IN RESPONSE TO THE "ADDR?" PROMPT, IF A CARRIAGE-RETURN OR A 
LINF.-FEED IS TYPED AS THE ONLY THING ON THE INPUT LINE, THE EXIT 
SEQUENCE WILL BE ENTERED, AT SUCH TIME, THE USER IS ASKED TO WRTTE-ENABLE 
THE OUTPUT DEVICE AND CONFIRM THE FACT THAT THE PATCHES SHOULD BE ENTERED 
INTO THE SPECIFIED FILE. 

IF A FILE IS MODIFIED BY THE IISE OF THE "PATCH" COMMAND, THE DATE AND 
LENGTH OF THE FILE OPtRATED UPON ARB UPDATED IN THE DEVICE DIRECTORY AS 
REQUIRED, 
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IF THE FILE BEING PATCHED CONTAINS HFPRfcSENTAT lOIIS OF ISOLATED SINGLE-BYTE 
DATA, FOB EXAMPLE THOSE GENEBATFD BY THE FOLLOWING ASSEMBLY 
CODE SEGUEHCtS; 

A. ,s24 
.BYTE 120 

.EVEI* jGENEPATFS ONLY 1 BYTE OF DATA 

B. .S413 
,BYTE-1 

.EVEN jGENEPATES ONLY 1 BYTE OF DATA 



C, .ODD 

.BYTE 6 

,s.+l jGENEPATES ONLY 1 BYTE OF DATA 

THE CONTENTS OF THE DATA BYTE REPPESENTED IN THt FILE mi ILL BE PROPERLY 

REPORTED IF EXAMINED USING THE "PATCH" COMMAND, BUT THE CONTENTS 

OF THE ADJACENT DATA BYTE WHICH OCCUPIES THE SAME WORD ADDRESS WILL BE 

REPORTED TO BE 0'S, SINCE IT IS NOT REPRESENTED IN THE FILE, 

FOR EXAMpLEj IN THE CASE OF A ABOVE, 



hDmi 24 <CR> 
000024 000120 

NOTE THAT THE CONTENTS OF THE 

UPPER BYTE ARE ACTUALLY UNKNOWN. 



AND B 

ADDP? 412 <CR> 
000 17 7400 

--.---NOTE UNKNOWN DATA IN LOW BYTE 
REPRESENTED BY 0'S. 
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5. ERRORS 



INVCMD INVALID COMMAND, CHECK COMMAND JUST GIVEN, 

INVDEV INVALID DEVICE SPECIFIED FOR COMMAND GIVEN, 

INVADR INVALID ADDRESS, MUST BE EVEN, WITHIN EXISTING LOCORE 

AND HICORE LIMITS, AND MUST NOT BF WITHIN UPDATE PROGRAM, 

INVNAM INVALID FILE NAME. NO SPECIAL CHARACTERS ALLOWED, 

A THROUGH I, AND THROUGH 9 ARE ONLY VALID CHARACTERS, 
ALSO OCCURS IF # OR WILD CHARACTER CONSTRUCTION FILENAMES 
ARE SPECIFIED TO A COMMAND THAT DOES NOT ALLOW IT. 

NEXFIL NON-EXISTENT FILE. FILE DOES NOT EXIST IN DEVICE DIRECTORY, 

DELOLD DELETE OLD FILE BEFORE GIVING COMMAND THAT WOULD CREATE 

FILE WITH SAME NAHt, 

DEVERP DEVICE ERROR ON EITHER INPUT OR OUTPUT DEVICE, CHECK 

THAT OUTPUT DEVICE IS WRI TE-ENABLED . 

NOTFDY PAPER TAPE DEVICE IS NOT READY, MAKE IT READY, 

CKSMER CHECKSUM ERROR DURING "LOAD" COMMAND, 

EOM END OF MEDIUM, OCCURS DUPING INPUT OPERATIONS WHEN THE 

PROGRAM ATTEMPTS TO INPUT AND THE FILE IS AT AN END. 
SERIOUS PROBLEM, FILE IN STORAGE IS PROBABLY WIPED OUT, 
REFER TO CHAPTER 4 FOP MEDIUM TESTING COMMANDS. 

DEVFUL DEVICE FULL. APPLIES TO DECTApE AND DISK, NO MORE FILE 

STORAGE AVAILABLE. DELETE UNNECESSARY FILES AND TRY 
AGAIN, OR USE ANOTHER MEDIUM. 

INVCOR HIGH CORE LIMIT LOrtEP THAN LOWER CORE LIMIT. CORRECT 

COPE LIMITS. OCCURS DURING DUMP COMMAND, 

DIREPR INVALID NAME IN DEVICE DIRECTORY, 

DELERF BIT MAP ERROR DUPING DELETE OPERATION ON DECTAPE OR DISK, 

NOT USUAL UNLESS MEDIUM HAS BEEN WIPED OUT, TRANSFER 
FILES TO OTHER MEDIUM. (SEE CHAPTER 4,). 

POFLOW PROGRAM TOO LARGE TO LOAD WITHIN EXISTING CORE SPACE, 

INVSW INVALID SWITCH SPECIFIED IN COMMAND STRING, 

DUMP ERROR ACT MODE ONLY (SEE CHAPTER 7), OCCURS DURING DUMP 

COMMAND WHEN DATA DUMPED ON OUTPUT DEVICE DOES NOT MATCH 
DATA IN CORE. 
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5,1 ERRORS UNIQUE TO THE FILCMP COMMAND 



UNEQUAL FILE T¥PES INDICATES THE T»iO FILES fEING COMPARED 

ARE NOT OF SIMILAR STRUCTURE, 

UNEQUAL ULE SIZES INDICATES THE T1«0 FILES BEING COMPARED 

ARE HOT THE SAME SIZE, 

SCRATCH FitE SHORTER THAN MASTER FILE 

THE SCRATCH FILE IS THE FILE ON THE 
DEVICE WHICH IS ON THE LEET OF THE 
BACK ARROW IN THE COMMAND STRING, 

SCRATCH FILE LONGER THAN MASTER FILE 

THE SCRATCH FILE WHICH IS ON THE 
LEFT OF THE BACK ARROl* IS LONGER 
THAN THE FILE ON THE RIGHT. 

BLOCK COMPARE ERROR XTH BLOCK, YTH BYTE 

THIS INDICATES THERE wAS AN ERROR IN 
THE COMPARE, X AND Y INDICATE THE 
BLOCK NUMBER AND BYTE NUMBER «HEPE THE 
ERROR OCCURREOe 
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6, UPDATING XXDP MEDIA 



UPDATING XXDP MEDIA CONSISTS OF: 

A, PATCHING EXISTING PROGRAMS (DhPO), OR 

B, REPLACING PROGRAMS WITH NtwiER VERSIONS, OR 

C, ADDING NEW PROGRAMS, 

WHEN FIRST BECOMING ACQUAINTED WITH THE USE OF THE UPDATE PROGRAMS 
THE USER SHOULD MAKE EXTRA SURE THAT A BACKUP FOR THE MEDIUM 10 
BE MODIFIED EXISTS, IN ORDER TO BE ABLE TO RECOVER FROM FATAL ERRORS. 
(ZEROING THE MEDIUM, DELETING THE WRONG FILE, ETC,). 

6,1 PATCHING EXISTING PROGRAMS 



PATCHING A PROGRAM IN A XXDP MEDIUM CONSISTS OF; 



A, LOADING EXISTING PROGRAM INTO MEMORY (LOAD COMMAND) 

B. MAKING MODIFICATIONS (PATCHING - MOD COMMAND) 

C, DELETING OLD PROGRAM (DEL COMMAND) 

D. STORING MODIFIED PROGRAM (DUMP COMMAND). 

AN ALTERNATE, SAFER, PROCEDURE WOULD STORE THE PATCHED PROGRAM FIRST, 
AND THEN AFTER TRYING THE MODIFIED PROGRAM, THE OLD PROGRAM iwOULD 
BE DELETED, 



EXAMPLE: 



•LOAD DT0;D0SA0,BIN 
*MOD J450 

0t>3l45f» 012737 0PkJ(100 
•MOD 3766 

003766 012737 0f0000 
003770 000005 000000 
•DEL DT0:D0SA0,B1N 
•DUMP DT0:D0SAI ,blN 
•LOAD DT0:D0SA1 .BIN 
•START 200 



(LOAD PROGRAM) 
(MODIFY PROGRAM) 



(DELETE OLD PROGRAM) 
(STORE MODIFIED PROGRAM) 
(LOAD NEW PROGRAM) 
(TRY OUT NEW PROGRAM) 



IT IS IMPORTANT WHEN IMPLEMENTING DEPO'S THAT THE Nfi^E 01- THE 
PROGRAM REFLECT THE DFPO LEVEL OF THE PROGRAM, SEE APPENDIX D. 
PROGRAM NAMING COtJ VENT IONS , 
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6.2 RFPLACING PPOGHAMS wITH Nt«KR VfcHSlONS, UR 



ADDING MEW PP(>GRAf«'.S 



TO REPLACE A PROGRAM, OP TO APU A NEW ONE: 

A. DEtETE OLD PROGRAM IF Pf PLACING IT, 

B. LOAD NEW PROGRAM INTO MtMORV, 

C. DUMP PPOGRAM ONTO DEVICE, 



EXAMPLE 1: 

*DEL DT«!DPSA1 ,HIN 
•LOAD PPj 

• DUMP DTt)lD«SB0,BIN 

• LOAD DT0:D0Shk?,BIN 

• START 2^*» 

EXAMPLE 2: 

DEL CTdlDOSAl ,BIN 
LOAD PR: 

DUMP CT0:D0SB^,HIh 
LOAD Cr0:D0SB0,hIN 



(DELETE OLD PROGRAM) 
(LOAD NEw PROGRAM ) 
(STORE NEW PFOGPAM) 
{LOAD NEW PROGRAM) 
(TRY NEW PROGRAM) 



lOEI ETES OLD PROGRAM . 

I LOADS NE«. PROGRAM FROM PAPER TAPE, 
;ADDS NEW PROGRAM, 

rCHKCKS THAT PkOGRAM LOADS CORRECTLY, 



NOTE: DELETING A PROGRAM FROM CASSETTE OB MAGTAPE DOES NOT PHYSICALLY 
REMOVE THE PROGRAM FROM THE MEDIUM, IT STILL TAKES UP SPACE. TO 
CLEAN UP THE CASSETTE OR MAGTAPE, IT MUST faE COPIED VIA ITS XXDP 
MONITOR'S COPY ROUTINE, WHICH COPIES ONLY "GOOD" FILES. 



*PIP DT0:OVLY, BIN-PR: (PIP TO OT«s FROM PR:) 

•LOAD DT0:OVLY.BIN (LOAD OVERLAY) 

RELOADING OF A PPOGPAM THAT HAS BEEN "plppED" DIRECTLY TO A DEVICE 
IS IMPORTANT, TO INSURE THAT NO READING ERROPS HAVt OCCURRED. 
THE PIP COMMAND DOES NOT CHECKSUM INPUT DATA. 
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6.3 GENERATING A XXDP MEDIUM 



IT MAY BE DESIRABLE TO CREATE A CUSTOM MADE MEDIUM CO^rAINING ONLY 
THOSE PROGRAMS REQUIRED TO TEST A PARTICULAR SYSTEM. AS AN EXAMPLE, 
SUCH A MEDIUM COULD CONTAIN: 

A. PROCESSOR TESTS 

B. MEMORY TESTS 

C. I/O PROGRAMS FOR THAT SYSTEM 

WITH SUCH A MEDIUM, THE ENTIRE SYSTEM COULD BE TESTED USING THE 

CHAIN MODE OF OPERATION, WITHOUT HAVING TO SWITCH DECTAPES, OR CASSETTES. 

THE PROCEDURES FQP GENERATING A NEW MEDIUM FOLLOW. 

6.3.1 CREATING A NEW XXDP OECTAPE 



•ZERO DTI: (ZERO OUT NEW OECTAPE) 

♦LOAD DT0:TCDP.BIN (GET DECTAPE MONITOR) 

•SAVM DTI: jSAVE TCDP AS BOOTABLE CORE IMAGE, 

♦DUMP OTl:TCDP,BIN (SAVE MONITOR AS A FILE) 

•LOAD DT0:UPD1.BIN (LOAD UPDl PROGRAM) 

•DUMP DTl:UPDl.BIN (COPY OF UPDl GOES ON NEW TAPE) 

LOAD nT0!UPD2.BIN (GfT UPD2 PROGRAM) 

DUMP DT1:UPD2.BIN (COPY OF UP02 GOES ON NEW TAPE) 



FROM THIS POINT ON, THE DESIRED PROGRAMS ARF TRANSFERRED FROM THE 
OTHER TCDP DECTApES TO THE NEW DECTApF, USING THE Pip, AND THE 
LOAD AND DUMP COMMANDS AS REQUIRED BY TYPE OF HLF 

*»»1HP0RTANT*»^ ABS FORMAT FILES (,BIN,,BIC) CAN BE TRANSFERRED BY 
MEANS OF THE PIP COMMAND. CORE IHAGF FILES (,SAV) MUST NOT. 
TO TRANSFER A CORK IMAGF FILE, THE GET AND SAVE COMMANDS MUST BE 
USED AS FOLLOWS: 



•c 

•GET DT(»:A.SAV 
•SAVE DTI :A,SAV 



CORF IMAGE FILES MUST BL Tt-ANSFERREO TO THE NFW DECTAPE FIRST, SINCE 
THEY REQUIRE CONTIGUOUS BLOCK ALLOCATION, WAITING UNTIL OTHER LINKED 
FILES HAVE BEEN TRANSFERRED MAY RESULT IN THE LACK OF SUFFICIENT 
CONTIGUOUS BLOCKS TO STOPt A CORE IMAGE FILE. 



AFTER THE NEW DECTAPE IS COMpl.tTED, ALL PROGRAMS SHOULD BE LOADED 
FROM IT, TO INSURE THEY HAVE BEEN STORED CORRECTLY, ADO I T I ON A LL Y , 
THE DECTAPE SHOULD BE DUPLICATED, 10 PROVIDE A ^^ACMIP. 
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6.3,2 CREATING A NEW XXDP OECPACK 



A. MOUNT THE "1»Eto" DISK ON OPIVt 1 

B. MOUNT THE "OLO" DISK ON DPIVE 0, 

C. PERFORM THE FOLLOWING COMMANDS; 

ZERO DKl: ;ZERO MEW DISK. 

LOAD DK0tPKDP.BIN 

SAVM OKI: 

DUMP DKttPKDP.eiN 

LOAD DK0:UPD1,BIN 

DUMP DKljUPDt.BIN 

LOAD DK0: UP02.BIN 

DUMP 0KiiUPD2.BIN 
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6,3,3 CREATING A NEW XXDP MAGTAPE 



A, MOUNT "NEW" MAGTAPE ON DRIVE 1 

B, MOUNT "OLD" MAGTAPE ON DRIVE 

C, PERFORM THE FOLLOWING COMMANDS: 

FOR A TMll 

ZERO MTl: 
LOAD »T0:THDP.BIN 
SAVE HT1:THDP.SAV 
LOAD MT0:THDP.BIN 
SAVE MTlsTHDP.SAV 
LOAD MT0:THDP,BIN 
DUMP HTltTHOP.BIN 
LOAD MT0:THDP,BIN 
DUMP MTltTMDP.BIN 
LOAD MT0:UPO1,BIN 
DUMP MTUUPDl.BIN 
LOAD MT0: UPD2.BIN 
DUMP MT1:UPD2.BIN 



FOP A TM02 


ZERO 


MMl 




LOAD 


MH0 


SMMDP.BIN 


SAVE 


MMl: 


MMDP,SAV 


LOAD 


MM0. 


.TMDP.BIN 


SAVE 


MM1< 


THOP.SAV 


LOAD 


HM0< 


,MMDP,BIN 


DUMP 


MMl 


iMMDP.BIN 


LOAD 


MM0 


[TMDP.BIN 


DUMP 


MMl 


•TMDP.BIN 


LOAD 


MM0 


iUPDI .BIN 


DUMP 


MMl 


!UPD1 .BIN 


LOAD 


MM0 


: UPD2.BIN 


DUMP 


MMl 


!UPD2,BIN 
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6,3,4 CHEATING NF.W XXDP CASSETTF 



THt TAOP CASSETTt: ITSELF DOES NOT CONTAIN DIAGNOSTIC PHOGRAMS, HOWEVf H, 
A NEW CASSETTE COULD BE HUILT CONTAINING THE HEgUlRED PROGRAMS AND 
TO BE PUN UNDER TADP. 

A, MOUNT THE TADP CASSETTE ON CTkJJ 

B, MOUNT A "SCRATCH" CASSETTE ON CTl! 

C, PERFORM THE FOLLOWING COMMANDS! 

ZERO CTi! 

LOAD CT«! TALDRB.BIN 

SAVE CTt ;TALDPB,SYS jPLACES CASSETTE LOADER IN IMAGE FORM. 

LOAD AND DUMP THE REQUIRED PROGRAMS, BEFORE EACH PROGRAM IS LOADED 
THE CASSETTE CONTAINING THE PROGRAM MUST BE LOADED IN CT0: EXAMPLE: 

LOAD CT0JGTP.BIN 
DUMP CTISGTP.BIN 



6.3,5 CREATING A NEW XXDP DISKETTE 



A. MOUNT THE "HEW" DISKETTE ON DRIVE I, 
^, mm^^HiE^ "OL D" DISKETTE ^H&fri¥€ 13^. 
C, PERFORM THE FOLLOWING FUNCTIONS: 

ZERQ DXl! 

LOAD DX0: RXOP.BIN 
SAVM DXl: 

LOAD DX0: UPOl.BIN 

DUMP DXl: UPDl.BIN 

LOAD DX0: UPD2.BIN 

DUt«P DX0: UPD2,B1N 
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6.3,6 CREATING A NEW XXDP RP03 DISK 



A, MOUNT THE "NErt" DISK PACK OU DPlVfc 1. 

B, MOUNT THE "OLD" DISK PACK ON DRIVE , 

C, PERJ-ORM THE FOLLOWING FUNCTIONS: 



ZFRO DPI 
LOAD DP0 
SAVM DPI 
LOAD DP0 
DUMP DPI 
LOAD DP0 
DUMP DPI 



RPDP.BIN 

UPDl .BIN 
UPDl .BIN 
UPD2,BIN 
UPD2,BIN 



6.1,7 CREATING A NEW XXDP RP01 DISK 



A, MOUNT THE "NEh" DISK PACK ON DRIVE I, 

B, MOUNT THE "OLD" DISK PACK ON DRIVE 0. 

C, PERFORM THE FOLLOi»IING FUNCTIONS: 



EEHO Dbl 
LOAD OP0 
SAV^? Dbl 
LOAD DBM 
DUMP DBl 
LOAD DBO 
DUMP DBl 



RPDP.BIN 

UPDl ,BIN 
UPDl .BIN 
UPD2,BIN 
!IPD2,BIN 



6,3,8 CREATING THE NE« XXDP RS03 DISK 



A, SELECT THE "NEW" DISK AS DRIVE 1, 

B, SELECT THE "OLD" DISK AS DRIVE 0, 

C, PERFORM THE FOLLOWING FUNCTIONS; 



ZERO DSl 
LOAD DS0 
SAVM DSl 
LOAD DS0 
DUMP DSl 
LOAD DS0 
DUMP DSl 



RSOP.BIN 

UPDl .BIN 
UPDl .BIN 
UPD2.BIN 
UPD2,BIN 
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b,i,9 CREATING A XXDP MEDIUH - COMMON PROCEUURF- 



ONCE THE MONITOR HAS BEEN SAVED ON THE MEDIUM, IJPDI.BIN AND UPD2,BIN 
SHOULD BE SAVED: 

FILEF DEVI :<DEV0:UPD?, BIN ;TftANSFERS UPDl.BlN AND UP02.B1N 

CONTIGUOUS (GORE-IMAGE) FILES SHOULD BE TRANSFERRED NEXT (TO GUARANTEE 
ROOM ON THE MEDIUM), THIS CAN BE DONE VIA THE FILEF COMMAND: 

FILE! DEVI j<DEV0: A.SAV ;TRANSFER A.SAV 

FROM THIS POINT ON, THE DESIRED PROGRAMS ARE TRANSFERRED FROM THE 
INPUT MEDIA TO THE OUTPUT MEDIUM VIA THE FILEF COMMAND, USE OF THE 
SPECIAL FEATURES CAN CONSIDERABLY DECREASE THE NUMBER OF COMMANDS 
REQUIRED, FOR EXAMPLE, TO TRANSFER ALL DECTAPE DIAGNOSTICS TO THE 
NEW MEDIUM A SINGLE FILEF COMMAND WILL SUFFICE: 

FILEF DEVI :<DEV0:XTC???,» jTRANsFERS ALL PROGRAMS WHOSE 

JNAMES START WITH "XTC" 

AFTER ALL THE DESIRED FILES HAVE BEEN STORED ON THE NFW MEDIUM, 
IT SHOULD BE TESTED VIA THE FILET, FILEL, AND FILEG COMMANDS: 

FILET DEVlJ».»/LP ;READ EVERY FILE ON THE NEW MEDIUM, 

SLISTING ALL INFORMATION ON THE 
jLlNE PRINTER 

FILEL 0EV1:*.BI?/N jLOAD ALL ABS FORMAT FILES 

;T0 VERIFY THAT NO ERRORS 
jOCGUR, LIST ERRORS ONLY, 

FILEG DEV1:».SA?/N jLOAD ALL CONTIGUOUS FILES TO 

; VERIFY THAT NO ERRORS OCCUR. 
jLIST ERRORS ONLY, 

IT IS ALSO A GOOD IDEA TO DUPLICATE THE HEW MEDIU4 TO PROVIDE A 
BACKUP, 
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7, ACT MODE OPERATION 



THE XXDP UPDATE PPOGRAM $2 (UPD2) AND UPD2P HAS A SPECIAL MODE OF OPERATION 
PEFEHRED TO AS THE "ACT MODE", THE USE OF THE UPD2 PROGRAM IN "ACT 
MODE" IS RESTRICTED TO MANUFACTURING USES, AND HAS NO APPLICATION 
IN THE FIELD. 

THIS CHAPTEP DESCRIBES THE COMMANDS PECULIAR TO "ACT MODE", AND 
DIFFERENCES IN OPERATION, 

THE COMMANDS AND SWITCHES AFFECTED BY "ACT MODE" APE: 

ACT COMMAND 

NOTACT COMMAND 

LOAD AND FILFL COMMANDS 



DUMP COMMAND 
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7.1 THfc "ACT" COHMANli 

THE UPD2 PSOGPAM »s LOAi>ED IS J" "HOTACT" mC'vi., TO PUT Tht PPOGKAM 
IN "ACT" MODE, TYPE: 

ACT<CP> jPUTS PP0r.HAf4 IN ACT MODE. 

THE PPOGPAM ENTEPS ACT HODE AND THEN TYPES; 

• 

THE UP02H PPOGPAM hHEN LOADED IS ALREADY Ih ACT MODE. 

7.2 THE "NOTACT" COMMAND 

TO TAKE THE PPOGPAM OUT OF ACT MODE TYPEs 
NOTACT<CP> 

THE PPOGPAM EXITS ACT MODE AND THEN TYPES? 

THE UPD2B PPOGHAH TYPES FOLLOWING MESSAGE BEFOPE TYPli4G 
THE ♦ BEFOPE EACH COMMAND; 
NOTE IN ACT MODElJi 



THE MESSAGE IS A WARNING TO THE USEP THAT THE ppOGPAM 
SHOULD BE IN ACT MODE WHEN GENERATING XXDP MEDIA. 
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7,3 LOAD AND FILEL COMMANDS 



THE LOAD AND f ILFL COMMANDS FUNCTION EXACTLY AS IN "NOTACT" MODE, 
WITH THE EXCEPTION THAT THE CONTENTS OF CORE LOCATIONS 46 AND 52 
ARE TYPED IN ADDITION TO THE USUAL DATA THAT IS TYPED AFTER A PROGRAM 
HAS BEEN LOADED. LOCATIONS 16 AND 52 CONTAIN INFORMATION THAT IS 
USED BY THE ACTll MONITOR IN ACTll TEST LINES IN MANUFACTURING 
FACILITIES. THE LOCATION 46 AND 52 INFORMATION Is TYPED ONLY IF 
THE PROGRAM'S LOWER CORE LI^IT IS EQUAL OP LOWER THAN 46, 

EXAMPLE: 

LOAD DK0:CKBNA0,BIN<CR> ;LOADS PROGRAM FROM DISK 0, THEN TYPES: 

XFP; 000001 CORE: 000000^005711 L0G46; 000000 L0G52: 000000 

IN THIS CASE LOC 46 AND 52 ARE 0, INDICATING THAT THE REQUIRED CORE 
INFORMATION IS HISSING, 

LOAD DK0:CKBRD0.BIC ;LOADS PROGRAM AND TYPES: 

XFR: 000001 CORE: 000000»015151 L0G46: 012042 LOG52; 040000 

IN THIS CASE* LOC 46 AND 52 CONTAIN THE REQUIRED INFORMATION, 



7.4 THE "DUMP" COMMAND 



THE "DUMP" COMMAND FUNCTIONS EXACTLY AS IN NOTACT MODE, BUT IN ADDITION 
PERFORMS THE FOLLOWING FUNCTIONS: 

PERFORMS AN AUTOMATIC SIMULATED "LOAD" OF THE PROGRAM JUST STORED 

ON THE OUTPUT DEVICE, AND COMPARES IT AGAINST THE CONTENTS IN CORE. 
IF THE DATA DOES NOT MATCH, A "DUMP ERROR" MESSAGE OCCURS, INDICATING 
THAT THE "DUMp" OPERATION DID NOT SUCCEED IN STORING THE PROGRAM 
CORRECTLY. AT THIS POINT A RETRY OF THE COMMAND SHOULD BE DONE 
AND IF UNSUCCESSFUL, A HAD OUTPUT DEVICE IS INDICATED, 

EXAMPLE: 

DUMP DK0:CKBPD0.BIC<CR> ;STORES PROGRAM ON DISK 0. 

XFP; 000001 CORE:000000,fll51Sl LOG46:012402 L0G52 :«»40000 

THE LAST PRINTOUT LINE IS THE RESULT OF SUCCESSFULLY COMPLETING THE 
AUTOMATIC SIMULATED "LOAD" OF THE PROGRAM FROM THE DISK. 
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CHAPTER 4, XTECO - XXDP TEXT EDITOF 
TABLE OF CONTENTS 



1. ABSTRACT 

2. REQUIREMENTS 

1. LOADING AND STARTING PROCEDURE 

4. HOW TO USE XTECO 

5. ERRORS 
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J. ABSTRACT 



THE XTECO - XXDP TEXT EDITOR PROGRAM ENABLES THE USER OF XXDP TO 
CREATE AND EDIT ASCII TEXT FILES. ALL EDITING CAN BE DONE BY USING 
A FEW SIMPLE COMMANDS. 

XTECO IS A CHARACTER ORIENTED EDITOR, ONE OR MORE CHARACTERS IN A LINE 
CAN BE MODIFIED WITHOUT RETYPING THE REST OF THE LINE. XTECO DOES NOT 
REQUIRE THAT LINE NUMBERS OR OTHER EXTRANEOUS INFORMATION BE ASSOCIATED 
WITH THE ASCII TEXT. 

XTECO OPERATES ON ASCII DATA FILES. A FILE IS AN ORDERED SET OF DATA 
ON SOME PERIPHERAL DEVICE. IN THE CASE OF XTECO, A DATA FILE IS SOME 
TYPE OF DOCUMENT, AN INPUT FILE MAY BE A NAMED FILE ON ANY DIRECTORY 
DEVICE (DiSKr MAGTAPE, DECTAPE, CASSETTE), AN OUTPUT FILE CAN BE WRITTEN 
ONTO ANY OF THE SAME DEVICES, 

THE INPUT FILE FOR A GIVEN EDITING OPERATION IS THE FILE TO WHICH THE 
USER WISHES TO MAKF CHANGES, IF THE USER IS USIMG XTECO TO CREATE 
A NEW FIIE, THERE IS NO INPUT FILE. THE OUTPUT FILE IS EITHER THE NEWLY 
CREATED FILE, OR THE EDITED VERSION OF THE INPUT FILE, 

IN GENERAL, THE EDITING PROCESS PROCEEDS AS FOLLOWS. THE USER SPECIFIES 
THE FILE HE WISHES TO EDIT, AND THEN A BLOCK OF TEST IS READ INTO CORE. 
THE USER MODIFIES THE TEXT BY USING THE VARIOUS EDITING COMMANDS. 
HE THEN APPENDS ADDITIONAL BLOCKS OF TEXT AND EDITS THEM UNTIL THE 
ENTIRE FILE HAS BEEN EDITED, AT WHICH POINT HE OUTPUTS THE EDITED FILE 
AND CLOSES IT, 

XTECO IS CAPABLE OF PERFORMING EDITING OPERATIONS FROM AND TO DEVICES 
CURRENTLY SUPPORTED BY THE XXDp UPDATE PROGRAMS • 1 AND • 2, REFER 
TO CHAPTER 3 FOR DETAILS, 
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2, REOUIHEMENTS 

THE MIMIKUM CONFIGUf<ATION FOR USING XTECO IS AS FULLOvsS: 

A. PDP-JJ PROCESSOR i«iITH BK MEMORY 

B. CONSOLE TtRMIhAL 

C. XXDP SUPPOPIED INPUT/OUTPUT DEVICE AS FOLLOWS: 

1, SINGLE RANDOM ACCESS DEVICE (RKI1/RK05, DECTAPt, EIC), 

2. SEQUENTIAL ACCESS DEVICE WITH 2 DRIVES (MAGTAPE, CASSETTE), 

3. LOADING Attl) STARTING PROCEDURE 

XTECO is LOADED BY TYPING H XTECO<CR> WHILE UNDER CONTROL OF THE 
XXDP MONITOR. ONCE LOADED THE PROGRAM AUTOMATICALLY STARTS AND TYPES 
THE FOLLOWING MESSAGE: 

DZQUG-E XTECO - XXDP TEXT EDITOR 
DATE: 

TYPE THE DATE A.CCOPDING TO THE FOLLQttiING FORMAT, FOLLOWED BY <CR>. 

DD-MMM-YY 

WHERE: 

OD IS THE DAY OF THE MONTH 

MMM Is THE MONTH OF THE YEAR (1ST THREE LETTERS) 

YY IS THE YEAR (LAST 2 NUMBERS) 

THE DASHES MUST ALSO BE TYPED, 

EXAMPLE: 28-FEB-75 

THE PROGRAM ECHOES BACK THE DATE AND THEN TYPES: 
RESTART: 0«»5730 ;PROGRAM'S RESTART ADDRESS, 

NOW GO TO STEP 4, HOW TO USE XTECO, 
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4, HOW TO USE XTECO 



AS PACKAGED, THE XTECO PROGRAM PROVIDES SEVERAL OF THE COMMANDS 
AVAILABLE UNDER THE UPD1/UPD2 PROGRAMS, IN ADDITION TO THOSE COMMANDS 
PROVIDED FOR EDITING PURPOSES. IT IS DONE SO AS TO MINIMIZE THE NEED 
FOR SWAPPING BACK AND FORTH BETWEEN THE XTECO AND UPD1/UPD2 PROGRAMS, 

THE COMMANDS THAT ARE COMMON BETWEEN UPD1/UPD2 AND XTECO ARE LISTED 
HERE, BUT NOT DESCRIBED, REFER TO CHAPTER 3, FOR DETAILED DESCRIPTIONS 
OF THOSE COMMANDS. 

XTECO COMMANDS ARE OF TWO TYPES: NON-EDIT TYPE COMMANDS, AND EDIT 
TYPE COMMANDS. 

THE NON-EDIT TYPE COMMANDS APE: 



FILL 


;UPDI/UPD2 EQUIVALENT 


BOOT 


;UPD1/UPD2 EQUIVALENT 


DIRLP 


;UPD2 EQUIVALENT 


DIR 


;UPD1/UPD2 EQUIVALENT 


DELETE 


;UPD2 /UPOl EQUIVALENT 


RENAME 


;UPD2 /UPDl EQUIVALENT 


TYPE 


;UPD2 EQUIVALENT 


PRINT 


;UPD2 EQUIVALENT 


TEXT 


; XTECO UNIQUE 


EDIT 


;XTECO UNIQUE 


TECO 


; XTECO UNIQUE 


<CR> 


;CARRIAGE RETURN IS THE NON-EDiT TYPE COMMAND 




;STRING TERMINATOR, 
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L 
C 
J 

ZJ 

S 

N 

T 
D 
K 
I 
A 

EX 

<ALT> 

<ALT><ALT> 



USED TO MOVE POINTER OME OR MORE LINES 

USED TO HOVE POINTER ONE OR MORE CHARACTERS . 

USED TO MOVE POINTER TO BEGINMING OF TEXT IN GOfE. 

USED TO MOVE POINTER TO END OF TEXT IN CORE, 

USED TO SEARCH FOR A CHARACTER SEQUENCE IN TEXT IN CORE 

USED TO SEARCH GORE AND REMAINDER OF INPUT FILE FOP 
A SPECIFIED CHARACTER SEQUENCE, 

USED TO TYPE ONE OP MORE TEXT LINES, 

USED TO DELETE ONE OR MORE CHARACTERS, 

USED TO DELETE (KILL) ONE OR MORE TEXT LINES. 

USED TO INSERT ASCII TEXT INTO THE TEXT BUFFER. 

USED TO APPEND ONE OR MORE TEXT BLOCKS TO TEXT faUFFER, 

OUTPUTS EDITED FILE TO OUTPUT DEVICE AND CLOSES OUTPUT. 

ECHOES A "S" , USED TO TERMINATE AN EDIT COMMAND. 

ECHOES 2 "S", USED TO TERMINATE LAST EDIT COMMAND, 
AND TO CAUSE EXECUTION OF ENTIRE COMMAND STRING, 



NOTE: ALT MAY BE ESC ON SOME TERMINALS, 

THE USER SHOULD BE AWARE OF THE USE OF THE FOLLOWING SPECIAL CHARACTERS? 



*C (CTRL C) 



"0 (CTRL 0) 



'U (CTRL U) 



RUBOUT 

OP 
DELETE 



;USEO TO EXIT OUT OF ANY COMMAND AND RETURN TO COMMAND 
jMODE, WILL CAUSE AN OPEN OUTPUT FILE TO BE CLOSED, 
;THE USER MUST BE CAREFUL NOT TO TYPE CTRL C, UNLESS 
;HE WISHES TO ABORT HIS OPERATION, IT IS SPECIALLY 
jTRUE WHEN EDITING A FILE, AS ALL WORK WILL BE WASTED, 

jUSED TO STOP PRINTING ON THE CONSOLE TERMINAL, 
;AS WHEN TYPING MULTIPLE LINES OF TEXT WHEN EDITING 
;A FILE. 

jUSED TO EMPTY OUT CONTENTS OF KEYBOARD BUFFER, 

;AS WHEN THE USER WISHES TO START TYPING HIS COMMAND 

{SEQUENCE ALL OVER AGAIN. 

;OSEO TO REMOVE ONE OP MORE CHARACTERS TYPED FROM 
jCOMMAND OR TEXT STRING. ONE DEPRESSION OF THE 
; RUBOUT KEY REMOVES ONE CHARACTER. 
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4,1 THE "TEXT"f "EDIT", AND "TFCO" COMMANDS 



TEXT, EDIT, AND TECO COMMANDS APE THE BASIC COMMANDS PROVIDED TO 
CREATE OP EDIT AN ASCII TEXT FILE, 

THE TEXT COMMAND IS USED WHEN THE USEP WISHES TO CREATE A NEW TEXT 
FILE, THE TEXT COMMAND DOES NOT PEQUIRE AN INPUT FILE, ONLY AN 
OUTPUT FILE. ALL EDITING COMMANDS APE AVAILABLE WITH THE EXCEPTION 
OF THE "A" (APPEND) COMMAND WHICH BECOMES A NO-OP COMMAND WHEM NO 
INPUT FILE EXISTS, 

THE EDIT COMMAND IS THE GENERAL PURPOSE COMMAND FOR EDITING AN 
EXISTING TEXT FILE, IT PERMITS THE USER TO EDIT AN INPUT FILE IN ONE 
TYPE OF DEVICE AND TO OUTPUT THE EDITED FILE TO A DIFFERENT TYPE 
DEVICE, ALL EDITING COMMANDS ARE AVAILABLE WHEN UNDER THE EDIT COMMANO, 

THE TECO COMMAND IS A SPECIALIZED VERSION OF THE EDIT COMMAND. UNDER 
THE TFCO COMMAND THE INPUT AND OUTPUT DEVICE/DRIVE MUST BE THE SAME 
(IT ASSUMES THEY ARE THE SAME), AND MUST BE RANDOM ACCESS TYPE 
DEVICES (DISK, DECTAPF) , THE EDITED OUTPUT FILE TAKES ITS NAME FROM 
THE NAME AND EXTENSION OF THE INPUT ULE, AND THE INPUT FILE IS 
RENAMED TO A ",BAK" EXTFNSION (FOR BACKUP), ALL EDITING COMMANDS 
ARE AVAILABLE. 

INDIVIDUAL COMMAND DESCRIPTIONS FOLLOW. 
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4.2 THE "TEXT" COMMAND 

THE TEXT COMMAND IS USED TO CREATE" A NEw TEXT FILE, THE EOHMAT IS: 

TEXT 0UTUEVJFILNAM,EXT<CP> 

WHERE OUTOEV; IS ANY DIRECTORY DEVICE, 

THE PROGRAM feILL TYPE: 

"MAKE OUTPUT READY. TYPE <CP> WHEN READY" 

INSURE THAT THE OUTPUT DEVICE IS READY AUD WRITE ENABLED, PRESS THE 
"CP" KEY ON THE CONSOLE TERMINAL WHEN READY TO PROCEED, THE PROGRAM 
IS NOw IN EDIT MODE, AND ONLY EDITING TYPE COMMANDS ARE VALID, THE 
PROGRAM PROMPTS THE USER BY TYPING AN ASTERISK (»). 

THE USER CAN AT THIS POINT TYPE AND EDIT HIS TEXT, REFER TO 
CHAPTER 4,5 INTRODUCTION TO EDIT TYPE COMMANDS, 

EXAMPLE: 

TEXT OK0! 1 -TXT<CR> 
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4.3 THE "EDIT" COMMAND 



THE "EDIT" COMMAND PERMITS THE USER TO EDIT A TEXT FILE FROM A 
SPECIFIED INPUT DEVICE, AND TO OUTPUT THE EDITED TEXT FILE ON TO 
A SPECIFIED OUTPUT DEVICE. THE COMMAND FORMAT IS: 

EDIT OUTDEV:FILNAH,EXT«INDEV:FILNAH.EXT<CR> 

BOTH OUTDEV: AND INDEV: MUST BE DIRECTORY DEVICES, FOR MAGTAPE OR 

CASSETTE, THE INpUT DEVICE DRIVE MUST BE DIFFERENT FROM THE DRIVE ASSIGNED 

TO THE OUTPUT. IF THE USER WISHES TO EDIT A FILE RESIDING ON PAPER 

TAPE, THE TAPE MUST FIRST BE TRANSFERRED TO A DIRECTORY DEVICE 

BY MEANS OF THE "PIP" COMMAND OF THE UPD2 PROGRAM, AND THEN EDITED 

AS DESCRIBED IH THIS DOCUMENT. ONCE EDITED, THE FILE MAY AGAIN BE 

TRANSFERRED TO PAPER TAPE BY MEANS OF THE "PlP" COMMAND OF THE UPD2 

PROGRAM. 



THE PROGRAM taILL TYPE; 

-MAKE OUTPUT READY, TYPE <CR> WHEN READY" 

INSURE THAT THE OUTPUT DEVICE IS READY AND WRITE ENABLED. PRESS THE 
•CR" KEY ON THE CONSOLE TERMINAL WHEN READY TO PROCEED. THE PROGRAM 
IS NOW IN EDIT MODE, AND ONLY EDITING TYPE COMMANDS ARE VALID, THE 
PROGRAM PROMPTS THE USER BY TYPING AN ASTERISK (•), 

THE USER CAN AT THIS POINT TYPE AND EDIT HIS TEXT, REFER TO 
CHAPTER 4.5 INTRODUCTION TO EDIT TYPE COMMANDS. 



EXAMPLES: 

EDIT DK0!2,TXT_DKH: 1 ,TXT<CF(> 
EDIT MTl :1 ,TXT_MTy! i .TXT<CP> 
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4.4 THF. "TfCO" CO"MAf*n 



THE -TFCO" COMMAND IS A SPEC 1 AL I EfciU, SHORT HAND VtFSlOM OF Trit; 
"EPIT" COMMAND, WHtN USTUil THF "TFCO" COMMAfID Tht IHpUT I)f;VICt;/«»>« 1 VK 
MUST Bt THE SAMF: AS FOH OUTPUT, ANi) THK TFCO COMMAND SO ASSUMtS. 
IH ADDITION, THt: COMMAND l& PKSFHVED FOh USK jsITH KANDO^l ACCESS 
DEVICES ONLY (OlSKS, DECTAFF ) . THE COMMAND FORMAT IS: 

TECO DEV;FILHA.M,KXT<Cf<> 

WHEPE DEV: is any RANDOM ACCESS DEVICE. 

IT IS IMpOf<TANT THAT THF USER bE AWAPE OF THE MKCHAMCS INVOLVED IM 
THE OPEPATIOh OF THE TECO COMMAND. THF SEQUENCE IS AS FOLLOwS: 

I . OPEN l«i*PUT FILE 

2. OPEN OUTPUT FILE, AND ASSIGN IT A ,TMp EXTENSION 
J, EDIT OPEPATIONS ARE PERFOPMED 

4. EDITING DONE. OUTPUT EDITED FILE TO ,TMp KILE. 

5. CLOSE THE .TMp FILE. 

6. RENAME THE .TMp FILE TO SAHF NAME AND EXTENSION AS THE INPUT FILE. 

7. RENAME THE INpUT FILE TO A .BAK EXTENSION. 

WHEN USING THE TECO COMMAND THE INPUT DEVICE MUST NOT CONTAIN A FILE 
talTH THE SAME NAME AS THE JNpOT FILE AND .BAK EXTENSION, IF THE 
USER WISHES TO PRESERVE THAT FILE, AS IT WILL BE DELETED IN THE PROCESS 
OF RENAMING THE INPUT FILE TO A .BAK EXTENSION. 

THERE IS MO CONCERN IF THE EXISTING ,BAK FILE IS MERELY A BACKUP 
FROM A PREVIOUS EDITING OPERATION. 

ALSO NOTE THAT THE TECO COMMAND MUST NOT BE USED TO EDIT A FILE WHICH 
HAS THE FILENAME EXTENSION ,BAK, THE FILE MUST FIRST BE RENAMED 
TO ANOTHER EXTENSION, 



THE PROGRAM WILL TYPE; 

"MAKE OUTPUT READY. TYPE <CR> WHEN READY" 

INSURE THAT THE OUTPUT DEVICE IS READY AND WRITE ENABLED. PRESS THE 
"CR" KEY ON THE CONSOLE TERMINAL WHEN READY TO PROCEED. THE PROGRAM 
IS NOW IN EDIT MODE, AND ONLY EDITING TYPE COMMANDS ARE VALID. THE 
PROGRAM PROMPTS THE USER BY TYPING AN ASTERISK (»), 

THE USER CAN AT THIS POINT TYPE AND EDIT HIS TEXT, REFER TO 
CHAPTER 4.5 INTRODUCTION TO EDIT TYPE COMMANDS. 



EXAMPLES: 



TECO DK0:1 .TXT<CR> 



TECO DTI :ABC.TXT<CP> 
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4,5 INTRODUCTION TO EDIT TYPE COMMANDS 

4,5.1 GENERAL EDITING COMMAND STRING SYNTAX 

XTECO COMMANDS MAY BE GIVEN ONE AT A TIME, HOWEVER, IT IS USUALLY 
MOPE CONVENIENT TO TYPE IN A SINGLE COMMAND STRING, SEVERAL COMMANDS 
THAT FORM A LOGICAL GROUP. AN EXAMPLE OF A COMMAND STRING IS SHOWN BELOW. 



•IHEADINGSNTAG:S2LTSS ; INSERTS WORD "HEADING", SEARCHES FOR STRING "TAG:", MOVES 

;POINTEP FORWARD 2 LINES AND TYPES LINE POINTED TO. 

A COMMAND STRING IS TYPED AFTER XTECO INDICATES ITS READINESS BY 
PRINTING AN ASTERISK, COMMAND STRINGS ARE FORMED BY MERELY TYPING 
ONE COMMAND AFTER ANOTHER, COMMAND STRINGS APE TERMINATED BY TYPING 
TWO CONSECUTIVE ALTMODES, 

EXECUTION OF THE COMMAND STRING BEGINS ONLY AFTER THE DOUBLE ALTMOOE 
HAS BEEN TYPED. AT THAT POINT, EACH COMMAND IN THE STRING IS EXECUTED 
IN TURN, STARTING AT THE LEFT. WHEN ALL COMMANDS HAVE BEEN EXECUTED, 
XTECO PRINTS ANOTHER ASTERISK, INDICATING READINESS TO ACCEPT ANOTHER 
COMMAND. 

IF SOME COMMAND IN THE STRING CAN NOT BE EXECUTED BECAUSE OF A 
COMMAND ERROR, EXECUTION OF THE COMMAND STRING STOPS AT THAT POINT, 
AND AN ERROR MESSAGE IS PRINTED. COMMANDS FRECEEDING THE BAD COMMAND 
ARE EXECUTED. THE BAD COMMAND AND THOSE FOLLOWING IT ARE NOT EXECUTED. 



4,5,2 COMMAND ARGUMENTS 



THERE ARE TWO TYPES OF ARGUMENTS FOR XTECO EDITING COMMANDS. SOMt 
COMMANDS REQUIRE NUMEPIC ARGUMENTS AND SOME OTHER COMMANDS REUUiRE 
ALPHANUMERIC (TEXT) ARGUMENTS. NUMERIC ARGUMENTS ARE DECIMAL INTEGERS. 
NUMERIC ARGUMENTS ALWAYS PRECEDE THE COMMAND TO WHICH THFY APPLY, 
A TYPICAL EXAMPLE OF A COMMAND TAKING A NUMERIC ARGUMENT IS THE 
COMMAND TO DELETE THREE CHARACTERS: "3D". 

ALPHANUMERIC ARGUMENTS ARE TEXTUAL ARGUMENTS MEANT TO BE INTERPRETED 
AS ASCII CODE BY XTECO. ALPHANUMERIC ARGUMENTS ALWAYS FOLLOW THE 
COMMAND TO WHICH THEY APPLY, AND THEY MUST ALWAYS BE TERMINATED BY 
AN ALTMODE. EXAMPLES OF ALPHANUMERIC ARGUMENTS ARE (1) TEXT TO BE 
INSERTED, AND (2) CHARACTER STRINGS TO BE SEARCHED, FOR, 

EXAMPLE: 

•ISOMETHINGSS ;THE ARGUMENT IS "SOMETHING" 

AS SHOWN IN THE ABOVE EXAMPLE, THE ALTMODE USED TO TERMINATE AN 
ALPHANUMFPIC ARGUMFNT HAY ALSO SERVE AS ONE OF THE TWO ALTMODES 
NECESSARY TO TERMI* "TE A COMMAND STRING 
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4e6 XTECO EDIT COMMANDS 



4.6.1 INPUT COHMARDS 



THE *A» {APPEND) COMMAND 



THE "A* COMMAND READS IN THE NEXT BLOCK OF TEXT FROM THE INPUT DEVICE 
AND ADOS IT TO THE CONTENTS OF THE TEXT BUFFER IN CORE. 

THE "A" COMMAND ACCEPTS NUMERIC ARRUMENTS. EXAMPLE: 3ASS . HOWEVER, 
IT DOES NOT EXECUTE ANY OTHER COMMANDS FOLLOWING IT IN THE COMMAND 
STRING, IT IS MEANT TO BE USED SINGLY IN A COMMAND STRING. WHEN NOT 
ENOUGH CORE IS AVAILABLE TO SATISFY AH "A" COMMAND, XTECO OUTPUTS 
PART OF THE TEXT BUFFER ONTO THE OUTPUT DEVICE UNTIL THE REQUIREMENTS 
OF THE "A" COMMAND APE SATISFIED. 

4.6.2 BUFFER POINTER POSITIONING COMMANDS 



SINCE XTECO IS A CHARACTER-ORIENTED EDITOR, IT IS VERY IMPORTANT 
THAT THE USEP UNDERSTAND THE CONCEPT OF THE "BUFFER POINTER", THE 
POSITION OF THE BUFFER POINTER DETERMINES THE EFFECT OF MANY OF THE 
EDITING COMMANDS. FOR EXAMPLE, INSERTION AND DELETION ALWAYS TAKES 
PLACE AT THE CURRENT POSITION OF THE BUFFER POINTER. 

THE "BUFFER" IS THE CURRENT TEXT CONTENTS IN CORE, FROM THE FIRST 
CHARACTER, UP TO AND INCLUDING THE LAST CHARACTER. 

THE BUFFER POINTER IS SiMpLY A MOVABLE POSITION INDICATOR, IT IS 
ALWAYS POSITIONED BETWEEN TWO CHARACTERS IN THE BUFFER, OK BEFORE 
THE FIRST CHARACTER IN THE BUFFER, OR AFTER THE LAST CHARACTER IN 
THE BUFFER. THE POINTER MAY BE MOVED FORWARD OR BACKWARD OVER ANY 
NUMBER OF CHARACTERS. 
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THE "J" COMMAND 



THE "J" COMMAND MOVES THE POINTER TO THE BEGINNING OF THE BUFFER 
I.E.r IMMEDIATELY BEFORE THE FIRST CHARACTER IN THE BUFFER. 

THE "ZJ" COMMAND 



THE "ZJ" COMMAND MOVES THE POINTER TO THE END OF THE BUFFER. I.E., 
TO POSITION FOLLOWING LAST CHARACTER IN THE BUFFER. 

THE "C" COMMAND 



THE "C" COMMAND MOVES THE POINTER ONE CHARACTER IN THE BUFFER, THE 
"C" COMMAND MAY BE PRECEEDED BY A (DECIMAL) NUMERIC ARGUMENT. THE 
COMMAND "NC" MOVES THE POINTER FORWARD OVER "N" CHARACTERS, THE 
COMMAND "-NC" MOVES THE POINTER BACKWARD OVER "N" CHARACTERS, (THE 
POINTER CANNOT BE ADVANCED BEYOND THE ENDS OF THE BUFFER). 

THE "L" COMMAND 



THE "L" COMMAND IS USED TO ADVANCE THE BUFFER POINTER OR MOVE IT 
BACKWARD, ON A LINE-BY-LINE BASIS. THE "L" COMMAND TAKES A NUMERIC 
ARGUMENT, WHICH MAY BE POSITIVE, NEGATIVE, OR ZERO, AND IS UNDERSTOOD 
TO BE ONE (1) IF OMITTED. 

SUPPOSE THE BUFFER POINTER IS POSITIONED AT THE BEGINNING OF LINE "B" 
OR AT SOME POSITION WiTHIM LINE "B" . 

THE COMMAND L OR IL, ADVANCES THE POINTER TO THE BEGINNING OF LINE B+1. 

THE COMMAND NL, WHERE N>», ADVANCES THE POINTER TO THE BEGINNING 
OF LINE B+N. 

THE COMMAND -BL MOVES THE POINTER TO THE BEGINNING OF LINE H. IF THE 
POINTER IS ALREADY AT THE BEGINNING, NOTHING HAPPENS. 

THE COMMAND -L OP -IL MOVES THE POINTER BACK TO THE BEGINNING OF 
LINE B-1 . 

THE COMMAND -NL MOVES THE POINTER BACK TO THE BEGINNING OF LINE B-N. 

NOTES EXECUTION OF THE "A" (APPEND) COMMAND DOES NOT CHANGE THE 
POSITION OF THE BUFFER POINTER, 



NAINDEC-t 1-DZQXA-l-D XXOP USEH MANUAL 21 JULY 1976 
DZOXAl.Pii 



MACTfll 27(732) 24-JUh-7b 15:59 PAGE 8b 



SKQ 0085 



4.6,3 TEXT T¥PE-OUT COMMANDS 



THt *T" COMMAND 



VARIOUS PARTS OF THE TEXT IN THE BUFKEH CAN BE T^PED OUT FOR EXAMINATION 
BY USE OF THE "T" COMMAND, JUST WHAT IS TYPED OUT DEPENDS ON THE 
POSITION OF THE HUFFER POINTER AHO THE ARGUMENT GIVEN, THE "T" COMMAND 
NEVER MOVES THE BUFFER POINTER. 

THE "T" COMMAND TYPES OUT EVERYTHING FROM THE BUFFER POINTER THROUGH 
THE NEXT LINE FEED. THUS, IF THE POINTER IS AT THE BEGINNING OF 
A LINE, THE T COMMAND CAUSES THAT LINE TO BE TYPED OUT. IF THE 
POINTER IS IN THE MIDDLE OF A LINE, T CAUSES THE PORTION OF THE LINE 
FOLLOWING THE POINTER TO BE TYPED, 

THE COMMAND NT (N>«) IS USED TO TYPE OUT N LINES I.E., EVERYTHING 
FROM THE BUFFER POINTER THROUGH THE NTH LINE FEED FOLLOWING IT. 

THE USER, ESPECIALLY ONE NEW TO XTECO, SHOULD USE THE T COMMAND 
OFTEN, TO MAKE SORE THE BUFFER POINTER IS WHERE HE THINKS IT IS. 

DURING EXECUTION OF" ANY T COMMAND, THE USER MAY STOP THE TErMlNAL 
OUTPUT BY TYPING THE "0 (CTRL 0) CHAhACTER, THE TYPEOUT STOPS AND 
EXECUTION OF THE REMAINDER OF THE COMMAND STRING IS ABORTED. THEREFORE* 
LENGTHY TYPEOUTS SHOULD BE RESTRICTED TO SINGLE COMMAND, COMMAND STRINGS, 
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4,6,4 DELETION COMMANDS 



THE "D" COMMAND 



INDIVIDUAL CHAPACTERS APE DELETED BY USING THE "D" COMMAND, THE 
COMMAND "D" DELETES THE CHAPACTEP IMMEDIATELY FOLLOWING THE BUFFER 
POINTER, THE COMMAND "ND", WHERE N > DELETES THE N CHARACTERS 
IMMEDIATELY FOLLOWING THE POINTER. EXAMPLES! DSS, 3D$S» 50SS 

THE "K" COMMAND 



LINES ARE DELETED BY USING THE "K" COMMAND, THE "K" COMMAND 
MAY BE PRECEEDED BY A NUMERIC ARGUMENT, WHICH IS UNDERSTOOD TO BE 
A 1 IF OMITTED, THE COMMAND "NK" (N >0) DELETES EVERYTHING FROM THE 
CURRENT POSITION OF THE BUFFER POINTER THROUGH THE NTH LINE FEED 
CHARACTER FOLLOWING THE POINTER, 

AT THE CONCLUSION OF A D OR K COMMAND THE BUFFER POINTER IS POSITIONED 
BETWEEN THE CHAPACTERS WHICH PRECEDE AND FOLLOW THE DELETION. 
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4,6,5 INSERTION COHHASD 



THE OHhX INSERTION COMMAND IS THE COMMAND, THE ASCII TEXT THAT 

IS TO Bt INSERTED INTO THE BUFEER IS TYPED IMMEDIATELY AFTER THE 
LETTER I, THE TEXT TO BF INSERTED IS TERMINATED BY AN ALTMOOE, 

ANY ASCII CHARACTER EXCEPT MULL, ALTMGOE, RUBOUT, CTRL C, CTRL 0, ftfJD 
CTRL U MAY BE INCLUDED IN THE TEXT TO BE INSERTED, 

IF A CARRIAGt RETURN IS TYPED IH AN INSERTION, IT IS AUTOMATICALLY 
FOLLOWED BY A LIKE FEED. THE TEXT TO RE INSERTED IS PLACED IN THE 
BUFFER AT TrfE POSITION OF THE BUFFER POINTER, I.E., BETWEEN THE 
CHARACTERS, AT THE CONCLUSION OF THE INSERTION COMMAND THE BUFFER 
POINTER IS POSITIONED AT THE END OF THE INSERTION, 

ANY NUMPEF OF LINES MAY BE INSERTED WITH A SINGLE "I" COMMAND. 
HOWEtfER, IT IS RECOMMENDED THAT NO MORE THAN 10 TO 2W LINFS SHOULD 
BE INSERTED tolTH EACH I COMMAND. 
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SEQ 00B8 



4,6.6 OUTPUT COMMANDS 



THE ONLY OUTPUT COMMAND AVAILABLE WITH XTECO IS THE "EX" (EXIT) COMMAND, 
THE "EX" COMMAND Is USED TO CONCLUDE AN EDITING JOB WITH A MINIMUM 
OF EFFORT, ITS USF IS BEST SHOWN BY AN EXAMPLE! 

SUPPOSE THE USER IS EDITING A 30 PAGE FILE AND SUPPOSE THE LAST ACTUAL 
CHANGE TO THE FILE IS MADE ON PAGE 10. AT THIS POINT THE USER GIVES 
THE COMMANDS 



EX$$ 



THE ACTION OF XTECO IS (1) TO RAPIDLY MOVE ALL OF THE REST OF THE 
INPUT FILF TO THE OUTPUT FILE, (2) CLOSE THE FILE, AND (3) TO RETURN 
TO COMMAND MODE SO THAT THE USER HAY GIVE OTHER NON-EDIT MODE COMMANDS, 
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4.6,7 SEARCH COMMAMDS 



IN MANY CASES THE SiMPLtST HAY TO POSITION THE BUFFER POINTER IS BY 
USING A CHARACTER STRING SEARCH. A SEARCH COMMAND CAUSES XTECO TO 
SEARCH THROUGH THE TEXT UNTIL A SPECIFIED STRING OF CHARACTERS IS 
FOUND, AND THEN TO POSITION THE POINTER AT THE END OF THIS STRING. 
THERE ARE TWO SEARCH COMMANDS, 

THE "S" COMMAND 



THE "S"' COMMAND IS USED TO SEARCH FOR A CHARACTER STRING WITHIN THE 
BUFFER, THE STRING TO BE SEARCHED FOR IS SPECIFIED AS AN ALPHANUMERIC 
ARGUHENT FOLLOtoING THE S COMMAND, THIS ARGUMENT MUST BE TERMINATED 
BY AN ALTMODE. 

EXECUTION OF THE S COMMAND BEGINS AT THE POSITION OF THE BUFFER POINTER 
AND CONTINUES TO THE END OF THE BUFFER. IF THE SPECIFIED STRING IS 
NOT FOUND AN ERROR MESSAGE IS PRINTED AND THE BUFFER POINTER IS SET 
TO THE POINT WHERE THE SEARCH BEGAN, 

THE "N" COMMAND 



THE "H" COMMAND WORKS JUST LIKE THE -S" COMMAND, THE DIFFERENCE IS 
THAT AN S COMMAND ENDS AT THE END OF THE BUFFER, WHEREAS THE N 
COMMAND DOES NOT. AN N SEARCH BEGINS LIKE AN S SEARCH BUT IF THE 
CHARACTER STRING IS NOT FOUND IN THE CURRENT BUFFER AN AUTOMATIC "A" 
(APPEND) COMMAND IS EXECUTED AND THE SEARCH CONTINUED UNTIL THE SEARCH 
IS SUCCESSFUL OR THE INPUT FILE EXHAUSTED. 

IF THE N COMMAND FINDS THE SPECIFIED STRING THE POINTER IS POSITIONED 
AT THE END OF THE STRING FOUND, IF THE STRING IS NOT FOUND, AN ERROR 
MESSAGE IS PRINTED AND THE POINTER IS SET AT THE BEGINNING OF THE 
BUFFER, SINCE A GOOD PART OF THE FILE HAY ALREADY HAVE BEEN OUTPUT TO 
THE OUTPUT DEVICE, THE USER MAY HAVE NO OTHER CHOICE THAN TO EXIT 
VIA THE "EX" COMMAND, AND TO REOPEN THE FILE AND TRY THE N SEARCH 
AGAIN WITH A CHARACTER STRING THAT CAN BE FOUND, 

WARNING; WHEN ATTEMPTING TO SEARCH IT IS VERY EASY TO OVERLOOK 

AN OCCURRENCE OF THE SEARCH STRING PRECEEDING THE ONE 
THE USER DESIRES, FOR EXAMPLE, HE MAY WANT TO MOVE 
THE POINTER AFTER THE WORD "AND" BUT ERPOWEOUSLY 
POSITION THE POINTER AFTER A PRECEEDING OCCURRENCE 
OF A WORD LIKE "THOUSAND". 

FOR THIS REASON, THE USER IS STRONGLY URGED TO EXECUTE 
A "T" COMMAND TO ASCERTAIN THE POSITION OF THE POINTER 
AFTER EACH SEARCH COMMAND, 
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5. ERRORS 



ERROR MESSAGES GENERATED B¥ XTECO ARE THE SAME AS THOSE GENERATED 
BY XXDP UPDATE PROGRAMS i 1 AND I 2 (UPDl, UPD2)r AND HAVE THE SAME 
MEANINGS. 

IN ADDITION, ONE ERROR MESSAGE IS GENERATED BY XTECO WHEN A SEARCH 
FOP A CHARACTER STRING BY EITHER THE "S" OR "N" COMMANDS FAILSi 
IN THAT CASE XTECO TYPES: 

•NOT FOUND: ASCII STRING" 
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CHAPTER 5, COPY - XXDP COPY PROGRAM 



1. ABSTRACT 

2. REQUIREMENTS 

3. LOADING AND STARTING PROCEDURE 

4. HOW TO USE COPY 

5. ERRORS 



i 
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1, ABSTRACT 



THE COPY - XXDP COPY PROGRAM ENABLES THE USER OF XXDP TO CREATE A 
NEW MEDIUM EXACTLY THE SAME AS THE ORIGINAL XXDP MEDIUM. 

THE COPY PROGRAM ALLOWS ONLY COPYING ON THE SAME MEDIUMS. THE 
PROGRAM WILL NOT COPY ANYTHING OTHER THAN XXDP MATERIAL 
IT IS NOT A GENERAL PURPOSE COPY PROGRAM, 

THE COPY PROGRAM CONSISTS OF TWO CHAPTERS, THE COPY CHAPTER AND 
THE VERIFY CHAPTER, THE COMPLETION OF EACH CHAPTER WITHOUT ERRORS 
IS INDICATED ON THE TTY. 

2. REQUIREMENTS 



THE MINIMUM CONFIGURATION FOR USING COPY IS AS FOLLOWS: 

A, PDP-11 PROCESSOR WITH 8K MEMORY 

B, CONSOLE TERMINAL 

C, XXDP SUPPORTED INpUT/OUTPUT DEVICE AS FOLLOWS: 

1, RANDOM ACCESS DEVICE WITH 2 DRIVES (RKU/RKU5, DECIAPE, ETC). 

2. SEQUENTIAL ACCESS DEVICE WITH 2 DRIVES (MAGTAPE, CASSETTE), 
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3. 



LOADING AND STARtlNC. PROCEDURF. 



COPY IS LOADED BY TYPING R COPY<CR> WHILE UMDEH CONTROL OE THE XXDP 
MONITOR, ONCE LOADED THE PROGRAM AUTOMATICALLY STARTS AMD TYPES THE 
EOLLOMING MESSAGE: 

DZQUQ-A- COPY - XXDP COPY PROGRAM 21-JUL-76 

TYPE THE DATE ACCORDING TO THE FOLLOWING FORMAT, FOLLOWED BY <CK>. 
DD-MHM-YY 



WHERE; 



DD 

MMM 

¥Y 



IS THE DAY OF THE MONTH 

is THE MONTH Of THE YEAR (1ST THREE LETTERS) 
IS THE YEAR (LAST 2 NUMBERS) 



THE DASHES 



MUST ALSO BE TYPED. 



EXAMPLE; 



28-FEB-76 



THE PROGRAM ECHOES BACK THE DATE AND THEN TYPES: 



RESTART: NNNNNN 



J PROGRAMS RESTART ADDRESS. 
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4. HOW TO USE copy 



THE copy PPOGRAM ppQVlDES SEVFPAL OF THE COMMANDS AVAILABLE UNDER 
THE UP01/UPD2 PROGRAMS. IN ADDITION TO THOSE COMMANDS PROVIDED FOR 
COPYING PURPOSES. IT IS DONE SO AS TO MINIMIZE THE NFEO FOR SWAPPING 
BACK AND FORTH BETWEEN THE COPY AND UPDl, UPD2 PROGRAMS. 

THE COMMANDS THAT ARE COMMON BETWEEN UPD1/UPD2 AND COPY ARE LISTED 
HERE, BUT NOT DESCRIBED, REFER TO CHAPTER 3 FOR A DETAILED DESCRIPTION 
OF THOSE COMMANDS. 

THE COPY COMMANDS ARES 



FILL 


JUPD1/UPD2 EQUIVALENT. 


BOOT 


;UPD1/UPD2 EQUIVALENT, 


OIRLP 


:UPD1/UPD2 EQUIVALENT. 


DIP 


;UFD1/UPD2 EQUIVALENT. 


COPY 


JCOPY UNIQUE 


VERIFY 


•COPY UNIQUE. 



ZERO 



;UPU1/UPD2 EQUIVALENT. 
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4.1 THE "COPY" COMMAND 



COPY IS THE BASIC CQHMANU TO COPY XXDP SOFTWftSE, THE SOURCE AND 
DESTINATION MUST BF ON THE SAME MEDIUM, THE COMMAND STRING IS AS 
FOLLOWS; 

«COPY OEVN:=DEVNN:<CP>, 
OP 

•COPY DEVN:=DtVNNs /NEW<CP>, 

WHEPE N AND NN ARE THE DEVICE LOGICAL NUMBEHS. 
EXAMPLE: COPY PK0:sPKl: 

THIS COPIES BKl ONTO HK0. 
THE PROGRAM THEN TYPESj 

•MAKE OUTPUT READY, TYPE <CR> WHEN PEADY, 

THIS IS TO INFORM THE USER THAT THE OUTPUT DEVICE MOST BE POWERfcO UP, 
READY AND nPlTE ENABLED. wHEri ALL THESE fiEuUlREHENTS ARE HE! X'lpE <Ch> 
TO START THE COPY PROCESS. 

WHEN THE COPY IS COMPLETED A VERIFICATION PASS IS MADE. THIS PASS IS 
STARTED WHEN THE PROGRAM T^PES: 

•STARTING VERIFICATION. 

WHEN THE VERIFY PASS IS COMPLETE THE PROGRAM TYPES: 
VERIFY COMPLETE, COPY COMPLETE, 
THE COPY HAS NOW BEEN COMPLETED, 

WHEN THE OPTIONAL /NEW SWITCH IS USED THE COPY PROGRAM WILL COPY DlSKs 
OR DECTAPES OK A FILE BY FILE BASIS RATHER THAN ON A BLOCK BY BLOCK 
BASIS. THIS FEATURE IS USEFUL WHEN IT IS KNOWN THAT A MASTER DISK 
CONTAINS ONE OR MORE BAD BLOCKS WHICH ARE NOT BEING USED IN THE 
FILES CONTAINED IN THE DISK, AND THE USER WISHES TO COPY ALL FILES 
TO ANOTHER DISK. 
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4.2 



THE VERIfY COMMAND 



5. 



THE VERIFY COMMAND WILL ONLY DO A VKRIFICATION OF A XXDP MEDIUM, THE 
COMMAND STRING IS AS FOLLOWS: 

•VERIFY DEVN:DEVNN:<CR> 

WHERE THE N AND NN ARE THE DEVICE LOGICAL NUMBERS. 

THE PROGRAM THEN TYPES! 

•STARTING VERIFICATION, 

THE VERIFICATION HAS NOW BEGUN. 

WHEN THE VERIFICATION IS COMPLETE THE PROGRAM TYPES: 

•VERIFICATION COMPLETE. 

ERRORS 



NEXFIL 
DEVERR 
DEVFUL 
INVCMD 
INVNAM 
INVOEV 
INVADR 
CKSMEP 
EOM 

DELOLD 

DELERK 

INVCOR 

INVSW 

POFLOW 



JREPORTS FILE NOT FOUND, 

jREPOPTS A DEVICE ERROR, CHECK FOR READY, ON LINE ETC, 

jPEPORTS A DEVICE FULL, NO MOPE ROOM FOR FILES. 

; INVALID COMMAND, CHECK LAST COMMAND STRING, 

; INVALID NAME, FOR FILE OR COMMAND. 

•INVALID DEVICE, CHECK DEVICE TABLE. 

•INVALID ADDRESS, ADDRESS SHOULD BE EVEN. 

jLOAD {CHECKSUM) ERROR, 

•END OF MEDIUM ERROR, REACHED END OF MEDIUM BEFORE END OF FILE, 
jTELL HIM TO DELETE OLD ULE FIRST. 
jDELLTF ERROR, 
:COPE ERROR. 
jINVALID SWITCH, 

{PROGRAM OVERFLOW ERROR, NOT ENOUGH CORE. 
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APPENDIX A, XXDP RESIDENT MONITOR COMMANDS 



F<CP> 


SET CONSOLE FILL COUNT. 


D<CR> 


DIRECTORY ON THE TTY CONSOLE. 


D/F<CP> 


SHORT DIRECTORY ON THE TTY CONSOLE, 


D/L 


DIRECTORY ON THE LINE PRINTER. 


0/li/F 


SHORT DIRECTORY ON LINE PRINTER. 


B COPY 


STARTS THE COPY PROGRAM, 


R FILENAME 


STARTS INDICATED PROGRAM. 


L FILENAME 


LOADS DESIRED PROGRAM. 


S FILENAME 


STARTS DESIRED PROGRAM WHICH WAS LOADED UNDER "L" COMMAND. 


S ADDR 


STARTS PROGRAM AS SPECIFIED ADDRESS. 


C FILENAME 


RUNS DESIRED CHAIN TABLE, 


C FILENAME/QV 


RUNS DESIRED CHAIN IN QUICK VERIFY. 


E 0<CR> 


ENABLE DRIVE 0(TAOP ONLY) 


E l<CR> 


ENABLE DRIVE KTADP ONLY) 
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APPENDIX B. XXDP PESIDENT MONITOR ERRORS 



INVCMD/SW 

DEVEPR 
EDM 

INVADR 

CKSHER 
POFLO 

INVNAM 
NEXFIL 



INVALID COMMAND AND/OR SWITCH, CHECK COMMAND 
JUST GIVEN. 

DEVICE ERROR ON INPUT DEVICE, 

END OF MEDIUM. OCCURS DURING INPUT OPERATIONS 
WHEN THE PROGRAM ATTEMPTS TO INPUT AND THE FILE 
IS AT AN END. SERIOUS PROBLEM. FILE IN STOR- 
AGE IS PROBABLY WIPED OUT. 

INVALID ADDRESS. MUST BE EVEN WITHIN EXISTING 
LOCORE AND HICORE LIMITS. AND MUST WOT BE WITHIN 
UPDATE PROGRAM, 

CHECKSUM ERROR DUPING "LOAD" COMMAND, 

PROGRAM TOO LARGE TO LOAD WITHIN EXISTING COPE 
SPACE. 

INVALID CHARACTER TYPED FOR FILE NAME, 

NON-EXISTENT FILE, IF IN CHAIN MODE 
THE PROGRAM TO BE RUN DOES NOT HAVE 
.PIC EXTENSION. 
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FILL<C«> 


SETS UP TEBNINAL FOR CORRECT PRINT 








D[iCMTT<i MaHTMfl DDrtPDAM <iE'I C» <T a DT T Mf* 

rc>nnii>> Hj4Rim» rKUunAri v>K.iir ot An i 
OR NON SELF-STARTING, 


DUMP DEVJFILNAM.EXT 


WRITES MEMORY CONTENTS IN ABS FORMAT 


LOAD DEV:DILI*A«.EXT 


LOADS ABS FORMAT PROGRAM (.BIN, ,BIC) 


pip DEVlsFILNAM.fcXT-DEV2 


iFILNAM.EXT COplES FILE FROM ONE DEVICE TO ANOTHER. 


SAVE DEV;FILNAM,EXT 


WRITES MEMORY CONTENTS ONTO CONTIGUOUS BLOCKS 


GET DEV:FILI4AM.EXT 


LOADS CORE IMAGE PROGRAM 


MOD ADP 


MODIFIES CORE CONTENTS 


CORE 


TYPES PROTECTION LIMITS 


LOCOBE ADR 


FNTERS LOW PROTECTION LIMIT 


HICORE ADR 


ENTERS HIGH PROTECTION LIMIT 


DIR DEV: 


TYPES DEV DIRECTORY ON TTY 


ZERO DEV: 


ZEROES DEVICE DIRECTORY 


BOOT DEV: 


LOADS BLOCK OF DEV STARTING AT LOC 000004* 


SAVM DEV: 


WRITES 4K ONTO DEV STARTING AT BLOCK 30 


START 


STARTS PROGRAM AT LOC 000000 


START ADR 


STARTS PROGRAM AT ADR 


*C (CONTROL C) 


RETURN TO COMMAND MODE (OPEN OUTPUT FILE IS CLOSED), 


DEL DEV:FiLNAM.LXT 


DELETES FILE FROM DEVICE DIRECTORS, 
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APPENDIX D, UPD2 PROGRAM COMMANDS 

FILL<CR> SETS UP TERMINAL FOR CORRECT PRINT 

AFTER CRLF. 

CIiP<CI<> CLEARS CORE BtLOw UPDATE PROGRAM 

XFR<CP> PERMITS MAKING PROGRAM SELF-STARTING, 

OR NOW SELF-STARTING, 

DUMP OEVrFILNAH, EXT WRITES MEMORY CONTENTS IK ABS l-ORMAT 

LOAD DEV;DILNAH,EXT LOADS ABS FORMAT PROGRAM (,BI>I, ,BIC) 

PIP DEVI :F ILNAM.EXT«DEV2:F1LNAM, EXT COPIES FILE FROM ONE DEVICE TO ANOTHER, 

SAVE DEVSFILNAH.EXT WRITES MEMORY CONTENTS ONTO CONTIGUOUS BLOCKS 

GET DFVrFILNAM.EXT LOADS COPE IMAGE PROGRAM 

MOD ADR MODIFIES CORE CONTENTS 

COPE TYPES PROTECTION LIMTS 

LOCORE ADR ENTERS LOW PROTECTION LIMIT 

HICORE ADR ENTERS HIGH PROTECTION LIMIT 

DIP DEV: TYPES DEV DIRECTORY ON TTY 

DIBLP DEVs TYPES DEV DIPECTORY ON LINE PRINTER. 

DEL DEV:FILNAH.FXT DELETES FILE FROM DEV DIRECTORY 

PEN DEV:NEWNAM,EXT_DEV:OLDNAM,EXT RENAMES OLD FILE 

ZERO DEV: ZEROES DEVICE DIRECTORY 

BOOT DEVs LOADS BLOCK OF DEV STARTING AT LOC 000000 

SAVM DEVs WRITES 4K ONTO DEV STARTING AT BLOCK 30 

START STARTS PROGRAM AT LOC 000000 

START ADR STARTS PROGRAM AT ADR 

ACT PUTS UPD2 PROGRAM IN "ACT MODE" 

NOTACT takes UPD2 PROGRAM OUT OF "ACT MODE" 

FILE DEV!<DEV!FILENAM,EXT COPIES FILE(S) FROM ONE DEVICE TO 

ANOTHER, DELETING FILE OF SAME NAME 
BEFORE ''NG THE TRANSFER 
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FILEF DEVKOEVsFILNAH.EXT 

FILET D£V:FILNAM.EXT 

FILEL OEV:FlLWAM,EXT 

FILEG DEV:FILNAM.fcXT 

FILED DEVtFILNAM.EXT 
FILCHP DEV:<DEV:FILNAM,EXT 

PATCH 

TEXT OEV:FILHAM.EXT 
PRINT DEV;FILNA«.EXT 

TYPE DEV i FILwAM ,EXT 

DO dev:filnah.ext 

ASG PHYSICAL = LOGICAL 
EOT 

PATCH OEVsFILNAM.EXT 
FILCHP DEV:=DEV:FILNAM,EXT 

*C (CONTROL C) 
•Z (CONTROL Z) 

7 

I OR ; 
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SAHE AS FILE EXCEPT THAT WITH CASSETTE OH 

MAGTAPE FAST TRANSFERS ARE PERFORMED (NO OIR CHECKING) 

READS FILE AND CHECKS FOR DEVICE 
ERKOPS (FILE "TEST") 

LOADS FILES (ASSUMES ABS FORMAT) 
CHECKING FOR DEVICE AND CHECKSUM ERRORS 

LOADS FILES (ASSUMES CONTIGUOUS FORMAT) 
CHECKING FOR DEVICE AND FILE SIZE ERRORS 

DELETES NAMED FILES 

COMPARES TWO FILES AGAINST 
EACH OTHER ON TWO XXDP MEDIUMS, 

ENABLE THE USER TO PATCH A 
PROGRAM, 

CREATES TEXT FILE FOR PRINTING 
OR FOP COMMAND EXECUTION 

OUTPUTS A FILE TO THE LINE PRINTER 
(ASSUMES IT ENDS WITH A "Z) 

OUTPUTS A FILE TO THE COnSOLE TERMiNAL 

EXECUTES A COMMAND FILE. 

ASSIGNS A PHYSICAL DEVICE TO A 
LOGICAL DEVICE NAME 

WRITES END OF TAPE HARK (FILE) ON MAGTAPE 
OR CASSETTE AFTER TAPE HAS BEEN POSITIONED. 

ENABLES PATCHING CAPABILITIES 
TO A FILE ON THE XXDP MEDIA. 

COMPARES TWO FILES WITH 
EACH OTHER. 



RETURNS TO COMMAND MODE (OPEN OUTPUT FILE 
IS CLOSED), 

ENDS INPUT TO A TEXT FILE 

USED FOR FILE NAMING TO MEAN "ANY" 
(ANY FILE NAME OR ANY FILE EXTENSION) 

USED FOR FILE NAMING TO INDICATE A ^IhD 
CHARACTER (ANY CHARACTER WILL HATCH IT) 

USED IN A FILE OF EXECUTABLE COMMANDS 
TO START A COMMENT LINE WHICH IS TO 
BE TYPED DURING EXECUTION 
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SAME AS i BUT CAUSES A HALT AFTER 
THE COMMENT IS PRINTED 
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APPENDIX E, PERIPHERALS SUPPORTED BY UPDATE PPOGHAHS 



XXDP SUPPORTS OR WILL SUPPORT THE fOLLOtelNG DEVICES: 

PR: pen HIGH SPEED PAPER TAPE READER {UpDI,UpD2) 

PP: pen HIGH SPEED PAPER TAPE PUNCH (UpDl,UPU2) 

KBs TTY KEYBOARD, OP LOW SPEED READER (nPDj,UPD2) 

PT: TTY PRINTER AND PUNCH (UPD1,UPD2) 

DTN: TCn DECTAPE CUPDl N=0 OP 1), (UPD2, N=0-3) 

DKN; RKn/RK05 DISK (HpDl N=0 OR 1) (UPD2, N=0-3) 

HTNj T«n/TUiH MAGTAPE 7/9 TRACK CUPD2, Ns0-3) 

CTNs TAn CASSETTE (UPDl, Nsi* OR 1), (UPD2, N=0 OR 1 ) . 

DXii: j<XU/RXHi i-LQPPY DISK (UPDl N=M OR 1) (UPD2 , Nsfl OH 1) 

MMNs TM02/TU16 MAGTAPE (UPD2 ONLY» K=0-3) 

DPN: PPnC/RP02/RP03 (UPD2 ONLY, Ns0 OR 1) 

DBN: RP04 DISK (UPD2 ONLY, N=0 OR U 

DSN: RS04/RH11 DISK (UPD2 ONLY, Ns0 OR 1} 

OHN: RK6n/RK06 DISK (UPD2 ONLY, H-0-3) 



HAINDEC-l i-DEoXA-I-D XXDp USEP MANUAL 21 JULY 1976 
DZQXAI.Pl 1 



MAClfll 21(732) 24-JUN-76 15;b9 PAGF 105 



SEO 0104 



APPENDIX X^ PPOGRAM NAMING CONVENTIONS 



THE FOLLOWING PROGRAM NAMING CONVENTION HAS BEEN USED FOP XXOP. 
ITS USE WILL PERMIT USERS TO DETERMINE BOTH THE VERSION, AND THE 
MCN level of the STORED PPOGFAMS. CONTINUED USE OF THIS SCHEME WHEN 
PROGRAMS ARE UPDATED IN THE FIELD IS HIGHLY RECOMMENDED, 



D ZFPKAI 



I II III 

I II III « = INDICATES MCN LEVEL 

I II II = INDICATES NO MCN ISSUED 

I II II — ---A THRU Z s REVISION DESIGNATION 

I II I^ A THRU Z = PROGRAM DESIGNATION 

I II THRU 9 = OVERLAY DESIGNATION 

I II — - -2 DIGITS = OPTION DESIGNATION 

I I....... A = 11/05,15,20 PROCESSORS 

I B = 11/40 PROCESSOR 

I C = U/45 PROCESSOR 

I Z = ALL PROCESSORS 

I 

I— -.D INDICATES A DIAGNOSTIC PPOGRAM, AND IS NOT USED 
IN NAMING A PROGRAM, 



.BIN EXTENSION USED TO STORE PROGRAM IN ABS FORMAT, 

,SAV EXTENSION USED TO STORE PROGRAM IN CORE IMAGE FORMAT, 

.BIC EXTENSION INDICATES ABS FORMAT CHAINABLE PROGRAM. 

% 



